CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.12.0] - 2024-03-10
+
+### Added
+
+- `developmentModeHelp` Kong variable to customize help message for development flag.
+
 ## [0.11.0] - 2024-03-06
 
 ### Changed
@@ -128,7 +134,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - First public release.
 
-[unreleased]: https://gitlab.com/tozd/waf/-/compare/v0.11.0...main
+[unreleased]: https://gitlab.com/tozd/waf/-/compare/v0.12.0...main
+[0.12.0]: https://gitlab.com/tozd/waf/-/compare/v0.11.0...v0.12.0
 [0.11.0]: https://gitlab.com/tozd/waf/-/compare/v0.10.1...v0.11.0
 [0.10.1]: https://gitlab.com/tozd/waf/-/compare/v0.10.0...v0.10.1
 [0.10.0]: https://gitlab.com/tozd/waf/-/compare/v0.9.2...v0.10.0

_examples/hello.go

@@ -60,6 +60,7 @@ func main() {
 	cli.Run(&app, kong.Vars{
 		"defaultProxyTo":      "http://localhost:5173",
 		"defaultTLSCache":     "letsencrypt",
+		"developmentModeHelp": " Proxy unknown requests.",
 	}, func(_ *kong.Context) errors.E {
 		// Routes come from a single source of truth, e.g., a file.
 		var routesConfig struct {

kong_test.go

@@ -33,6 +33,7 @@ func TestKong(t *testing.T) {
 			"defaultProxyTo":      "http://localhost:5173",
 			"defaultTLSCache":     "letsencrypt",
 			"defaultTitle":        "test",
+			"developmentModeHelp": " Proxy unknown requests.",
 		},
 	)
 	require.NoError(t, err)
@@ -44,7 +45,7 @@ func TestKong(t *testing.T) {
 
 Flags:
   -h, --help            Show context-sensitive help.
-  -d, --development     Run in development mode and proxy unknown requests.
+  -d, --development     Run in development mode. Proxy unknown requests.
   -P, --proxy-to=URL    Base URL to proxy to in development mode. Default:
                         http://localhost:5173.
 

server.go

@@ -79,8 +79,8 @@ type Server[SiteT hasSite] struct {
 	// Logger to be used by the server.
 	Logger zerolog.Logger `kong:"-" yaml:"-"`
 
-	// Run in development mode and proxy unknown requests.
-	Development bool `help:"Run in development mode and proxy unknown requests." short:"d" yaml:"development"`
+	// Run in development mode. By default proxy unknown requests.
+	Development bool `help:"Run in development mode.${developmentModeHelp}" short:"d" yaml:"development"`
 
 	// Base URL to proxy to in development mode.
 	ProxyTo string `default:"${defaultProxyTo}" help:"Base URL to proxy to in development mode. Default: ${defaultProxyTo}." placeholder:"URL" short:"P" yaml:"proxyTo"`