1 files changed, 41 insertions, 0 deletions
diff --git a/vendor/clap/examples/escaped-positional.rs b/vendor/clap/examples/escaped-positional.rs
new file mode 100644
index 000000000..a0fff790b
--- /dev/null
+++ b/vendor/clap/examples/escaped-positional.rs
@@ -0,0 +1,41 @@
+// Note: this requires the `cargo` feature
+
+use clap::{arg, command, value_parser, ArgAction};
+
+fn main() {
+    let matches = command!()
+        .arg(arg!(eff: -f).action(ArgAction::SetTrue))
+        .arg(
+            arg!(pea: -p <PEAR>)
+                .required(false)
+                .value_parser(value_parser!(String)),
+        )
+        .arg(
+            // Indicates that `slop` is only accessible after `--`.
+            arg!(slop: [SLOP])
+                .multiple_values(true)
+                .last(true)
+                .value_parser(value_parser!(String)),
+        )
+        .get_matches();
+
+    // This is what will happen with `myprog -f -p=bob -- sloppy slop slop`...
+
+    // -f used: true
+    println!(
+        "-f used: {:?}",
+        *matches.get_one::<bool>("eff").expect("defaulted by clap")
+    );
+    // -p's value: Some("bob")
+    println!("-p's value: {:?}", matches.get_one::<String>("pea"));
+    // 'slops' values: Some(["sloppy", "slop", "slop"])
+    println!(
+        "'slops' values: {:?}",
+        matches
+            .get_many::<String>("slop")
+            .map(|vals| vals.collect::<Vec<_>>())
+            .unwrap_or_default()
+    );
+
+    // Continued program logic goes here...
+}