add dd_style arguments to man and md generation

complete/src/fish.rs

@@ -108,6 +108,7 @@ mod test {
                         value: Value::No,
                     }],
                     long: vec![],
+                    dd_style: vec![],
                     help: "some flag",
                     value: Some(hint),
                 }],

complete/src/lib.rs

@@ -41,6 +41,7 @@ pub struct Command<'a> {
 pub struct Arg<'a> {
     pub short: Vec<Flag<'a>>,
     pub long: Vec<Flag<'a>>,
+    pub dd_style: Vec<(&'a str, &'a str)>,
     pub help: &'a str,
     pub value: Option<ValueHint>,
 }

complete/src/man.rs

@@ -54,6 +54,14 @@ pub fn render(c: &Command) -> String {
                 Value::No => {}
             }
         }
+        for (flag, value) in &arg.dd_style {
+            if !flags.is_empty() {
+                flags.push(roman(", "));
+            }
+            flags.push(bold(*flag));
+            flags.push(roman("="));
+            flags.push(italic(*value));
+        }
         page.text(flags);
         page.text([roman(arg.help)]);
     }

complete/src/md.rs

@@ -58,6 +58,10 @@ fn options(c: &Command) -> String {
             flags.push(format!("<code>-{flag}{value_str}</code>"));
         }
 
+        for (flag, value) in &arg.dd_style {
+            flags.push(format!("<code>{flag}={value}</code>"));
+        }
+
         out.push_str(&flags.join(", "));
         out.push_str("</dt>\n");
         out.push_str(&format!("<dd>\n\n{}\n\n</dd>\n", arg.help));

derive/src/complete.rs

@@ -33,16 +33,21 @@ pub fn complete(args: &[Argument], file: &Option<String>) -> TokenStream {
             continue;
         };
 
-        let Flags { short, long, .. } = flags;
-        if short.is_empty() && long.is_empty() {
+        let Flags {
+            short,
+            long,
+            dd_style,
+        } = flags;
+        if short.is_empty() && long.is_empty() && dd_style.is_empty() {
             continue;
         }
 
         // If none of the flags take an argument, we won't need ValueHint
         // based on that type. So we should not attempt to call `value_hint`
         // on it.
-        let any_flag_takes_argument =
-            short.iter().any(|f| f.value != Value::No) && long.iter().any(|f| f.value != Value::No);
+        let any_flag_takes_argument = !dd_style.is_empty()
+            && short.iter().any(|f| f.value != Value::No)
+            && long.iter().any(|f| f.value != Value::No);
 
         let short: Vec<_> = short
             .iter()
@@ -75,6 +80,11 @@ pub fn complete(args: &[Argument], file: &Option<String>) -> TokenStream {
             })
             .collect();
 
+        let dd_style: Vec<_> = dd_style
+            .iter()
+            .map(|(flag, value)| quote!((#flag, #value)))
+            .collect();
+
         let hint = match (field, any_flag_takes_argument) {
             (Some(ty), true) => quote!(Some(<#ty>::value_hint())),
             _ => quote!(None),
@@ -84,6 +94,7 @@ pub fn complete(args: &[Argument], file: &Option<String>) -> TokenStream {
             ::uutils_args_complete::Arg {
                 short: vec![#(#short),*],
                 long: vec![#(#long),*],
+                dd_style: vec![#(#dd_style),*],
                 help: #help,
                 value: #hint,
             }

examples/completion.rs

@@ -27,6 +27,10 @@ enum Arg {
     /// Give it a path!
     #[arg("-p P", "--path=P")]
     Path(PathBuf),
+
+    /// A dd_style argument!
+    #[arg("if=file")]
+    File(PathBuf),
 }
 
 struct Settings;