annotation to override default value

Signed-off-by: CrazyMax <crazy-max@users.noreply.github.com>

Author: crazy-max

annotation/annotation.go

@@ -20,4 +20,6 @@ const (
 	// CodeDelimiter specifies the char that will be converted as code backtick.
 	// Can be used on cmd for inheritance or a specific flag.
 	CodeDelimiter = "docs.code-delimiter"
+	// DefaultValue specifies the default value for a flag.
+	DefaultValue = "docs.default-value"
 )

clidocstool_md.go

@@ -202,7 +202,14 @@ func mdCmdOutput(cmd *cobra.Command, old string) (string, error) {
 			}
 
 			var defval string
-			if f.DefValue != "" && (f.Value.Type() != "bool" && f.DefValue != "true") && f.DefValue != "[]" {
+			if v, ok := f.Annotations[annotation.DefaultValue]; ok && len(v) > 0 {
+				defval = v[0]
+				if cd, ok := f.Annotations[annotation.CodeDelimiter]; ok {
+					defval = strings.ReplaceAll(defval, cd[0], "`")
+				} else if cd, ok := cmd.Annotations[annotation.CodeDelimiter]; ok {
+					defval = strings.ReplaceAll(defval, cd, "`")
+				}
+			} else if f.DefValue != "" && (f.Value.Type() != "bool" && f.DefValue != "true") && f.DefValue != "[]" {
 				defval = "`" + f.DefValue + "`"
 			}
 

clidocstool_test.go

@@ -106,6 +106,7 @@ func init() {
 	buildxBuildFlags.StringArrayP("output", "o", []string{}, `Output destination (format: "type=local,dest=path")`)
 
 	buildxBuildFlags.StringArray("platform", []string{}, "Set target platform for build")
+	buildxBuildFlags.SetAnnotation("platform", annotation.DefaultValue, []string{"local"})
 
 	buildxBuildFlags.Bool("push", false, `Shorthand for "--output=type=registry"`)
 

clidocstool_yaml.go

@@ -269,13 +269,25 @@ func genFlagResult(cmd *cobra.Command, flags *pflag.FlagSet, anchors map[string]
 
 	flags.VisitAll(func(flag *pflag.Flag) {
 		opt = cmdOption{
-			Option:       flag.Name,
-			ValueType:    flag.Value.Type(),
-			DefaultValue: forceMultiLine(flag.DefValue, defaultValueMaxWidth),
-			Deprecated:   len(flag.Deprecated) > 0,
-			Hidden:       flag.Hidden,
+			Option:     flag.Name,
+			ValueType:  flag.Value.Type(),
+			Deprecated: len(flag.Deprecated) > 0,
+			Hidden:     flag.Hidden,
 		}
 
+		var defval string
+		if v, ok := flag.Annotations[annotation.DefaultValue]; ok && len(v) > 0 {
+			defval = v[0]
+			if cd, ok := flag.Annotations[annotation.CodeDelimiter]; ok {
+				defval = strings.ReplaceAll(defval, cd[0], "`")
+			} else if cd, ok := cmd.Annotations[annotation.CodeDelimiter]; ok {
+				defval = strings.ReplaceAll(defval, cd, "`")
+			}
+		} else {
+			defval = flag.DefValue
+		}
+		opt.DefaultValue = forceMultiLine(defval, defaultValueMaxWidth)
+
 		usage := flag.Usage
 		if cd, ok := flag.Annotations[annotation.CodeDelimiter]; ok {
 			usage = strings.ReplaceAll(usage, cd[0], "`")

fixtures/buildx_build.md

@@ -24,7 +24,7 @@ Start a build
 | `--load` |  |  | Shorthand for `--output=type=docker` |
 | `--network` | `string` | `default` | Set the networking mode for the `RUN` instructions during build |
 | `-o`, `--output` | `stringArray` |  | Output destination (format: `type=local,dest=path`) |
-| `--platform` | `stringArray` |  | Set target platform for build |
+| `--platform` | `stringArray` | local | Set target platform for build |
 | `--push` |  |  | Shorthand for `--output=type=registry` |
 | `-q`, `--quiet` |  |  | Suppress the build output and print image ID on success |
 | `--secret` | `stringArray` |  | Secret file to expose to the build (format: `id=mysecret,src=/local/secret`) |

fixtures/docker_buildx_build.yaml

@@ -232,7 +232,7 @@ options:
   swarm: false
 - option: platform
   value_type: stringArray
-  default_value: '[]'
+  default_value: local
   description: Set target platform for build
   deprecated: false
   hidden: false