use crate::utils; use clap::{arg, error::ErrorKind, Arg, ArgMatches, Command}; #[cfg(feature = "suggestions")] static DYM: &str = "error: Found argument '--optio' which wasn't expected, or isn't valid in this context \tDid you mean '--option'? \tIf you tried to supply `--optio` as a value rather than a flag, use `-- --optio` USAGE: clap-test --option ... For more information try --help "; #[cfg(feature = "suggestions")] static DYM_ISSUE_1073: &str = "error: Found argument '--files-without-matches' which wasn't expected, or isn't valid in this context \tDid you mean '--files-without-match'? \tIf you tried to supply `--files-without-matches` as a value rather than a flag, use `-- --files-without-matches` USAGE: ripgrep-616 --files-without-match For more information try --help "; #[test] fn require_equals_fail() { let res = Command::new("prog") .arg( Arg::new("cfg") .require_equals(true) .value_parser(clap::builder::NonEmptyStringValueParser::new()) .takes_value(true) .long("config"), ) .try_get_matches_from(vec!["prog", "--config", "file.conf"]); assert!(res.is_err()); assert_eq!(res.unwrap_err().kind(), ErrorKind::NoEquals); } #[test] fn require_equals_fail_message() { static NO_EQUALS: &str = "error: Equal sign is needed when assigning values to '--config='. USAGE: prog [OPTIONS] For more information try --help "; let cmd = Command::new("prog").arg( Arg::new("cfg") .require_equals(true) .takes_value(true) .long("config"), ); utils::assert_output(cmd, "prog --config file.conf", NO_EQUALS, true); } #[test] fn require_equals_min_values_zero() { let res = Command::new("prog") .arg( Arg::new("cfg") .takes_value(true) .require_equals(true) .min_values(0) .long("config"), ) .arg(Arg::new("cmd")) .try_get_matches_from(vec!["prog", "--config", "cmd"]); assert!(res.is_ok(), "{}", res.unwrap_err()); let m = res.unwrap(); assert!(m.is_present("cfg")); assert_eq!(m.get_one::("cmd").map(|v| v.as_str()), Some("cmd")); } #[test] fn double_hyphen_as_value() { let res = Command::new("prog") .arg( Arg::new("cfg") .takes_value(true) .allow_hyphen_values(true) .long("config"), ) .try_get_matches_from(vec!["prog", "--config", "--"]); assert!(res.is_ok(), "{:?}", res); assert_eq!( res.unwrap().get_one::("cfg").map(|v| v.as_str()), Some("--") ); } #[test] fn require_equals_no_empty_values_fail() { let res = Command::new("prog") .arg( Arg::new("cfg") .takes_value(true) .require_equals(true) .value_parser(clap::builder::NonEmptyStringValueParser::new()) .long("config"), ) .arg(Arg::new("some")) .try_get_matches_from(vec!["prog", "--config=", "file.conf"]); assert!(res.is_err()); assert_eq!(res.unwrap_err().kind(), ErrorKind::EmptyValue); } #[test] fn require_equals_empty_vals_pass() { let res = Command::new("prog") .arg( Arg::new("cfg") .takes_value(true) .require_equals(true) .long("config"), ) .try_get_matches_from(vec!["prog", "--config="]); assert!(res.is_ok(), "{}", res.unwrap_err()); } #[test] fn require_equals_pass() { let res = Command::new("prog") .arg( Arg::new("cfg") .takes_value(true) .require_equals(true) .long("config"), ) .try_get_matches_from(vec!["prog", "--config=file.conf"]); assert!(res.is_ok(), "{}", res.unwrap_err()); } #[test] fn stdin_char() { let r = Command::new("opts") .arg(arg!(f: -f [flag] "some flag")) .try_get_matches_from(vec!["", "-f", "-"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("f")); assert_eq!(m.get_one::("f").map(|v| v.as_str()).unwrap(), "-"); } #[test] fn opts_using_short() { let r = Command::new("opts") .args(&[ arg!(f: -f [flag] "some flag"), arg!(c: -c [color] "some other flag"), ]) .try_get_matches_from(vec!["", "-f", "some", "-c", "other"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("f")); assert_eq!( m.get_one::("f").map(|v| v.as_str()).unwrap(), "some" ); assert!(m.is_present("c")); assert_eq!( m.get_one::("c").map(|v| v.as_str()).unwrap(), "other" ); } #[test] fn lots_o_vals() { let r = Command::new("opts") .arg(arg!(o: -o "some opt").multiple_values(true)) .try_get_matches_from(vec![ "", "-o", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", "some", ]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!(m.get_many::("o").unwrap().count(), 297); // i.e. more than u8 } #[test] fn opts_using_long_space() { let r = Command::new("opts") .args(&[ arg!(--flag [flag] "some flag"), arg!(--color [color] "some other flag"), ]) .try_get_matches_from(vec!["", "--flag", "some", "--color", "other"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("flag")); assert_eq!( m.get_one::("flag").map(|v| v.as_str()).unwrap(), "some" ); assert!(m.is_present("color")); assert_eq!( m.get_one::("color").map(|v| v.as_str()).unwrap(), "other" ); } #[test] fn opts_using_long_equals() { let r = Command::new("opts") .args(&[ arg!(--flag [flag] "some flag"), arg!(--color [color] "some other flag"), ]) .try_get_matches_from(vec!["", "--flag=some", "--color=other"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("flag")); assert_eq!( m.get_one::("flag").map(|v| v.as_str()).unwrap(), "some" ); assert!(m.is_present("color")); assert_eq!( m.get_one::("color").map(|v| v.as_str()).unwrap(), "other" ); } #[test] fn opts_using_mixed() { let r = Command::new("opts") .args(&[ arg!(-f --flag [flag] "some flag"), arg!(-c --color [color] "some other flag"), ]) .try_get_matches_from(vec!["", "-f", "some", "--color", "other"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("flag")); assert_eq!( m.get_one::("flag").map(|v| v.as_str()).unwrap(), "some" ); assert!(m.is_present("color")); assert_eq!( m.get_one::("color").map(|v| v.as_str()).unwrap(), "other" ); } #[test] fn opts_using_mixed2() { let r = Command::new("opts") .args(&[ arg!(-f --flag [flag] "some flag"), arg!(-c --color [color] "some other flag"), ]) .try_get_matches_from(vec!["", "--flag=some", "-c", "other"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("flag")); assert_eq!( m.get_one::("flag").map(|v| v.as_str()).unwrap(), "some" ); assert!(m.is_present("color")); assert_eq!( m.get_one::("color").map(|v| v.as_str()).unwrap(), "other" ); } #[test] fn default_values_user_value() { let r = Command::new("df") .arg(arg!(o: -o [opt] "some opt").default_value("default")) .try_get_matches_from(vec!["", "-o", "value"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_one::("o").map(|v| v.as_str()).unwrap(), "value" ); } #[test] fn multiple_vals_pos_arg_equals() { let r = Command::new("mvae") .arg(arg!(o: -o [opt] ... "some opt")) .arg(arg!([file] "some file")) .try_get_matches_from(vec!["", "-o=1", "some"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!(m.get_one::("o").map(|v| v.as_str()).unwrap(), "1"); assert!(m.is_present("file")); assert_eq!( m.get_one::("file").map(|v| v.as_str()).unwrap(), "some" ); } #[test] fn multiple_vals_pos_arg_delim() { let r = Command::new("mvae") .arg( arg!(o: -o "some opt") .multiple_values(true) .use_value_delimiter(true), ) .arg(arg!([file] "some file")) .try_get_matches_from(vec!["", "-o", "1,2", "some"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["1", "2"] ); assert!(m.is_present("file")); assert_eq!( m.get_one::("file").map(|v| v.as_str()).unwrap(), "some" ); } #[test] fn require_delims_no_delim() { let r = Command::new("mvae") .arg( arg!(o: -o [opt] ... "some opt") .use_value_delimiter(true) .require_value_delimiter(true), ) .arg(arg!([file] "some file")) .try_get_matches_from(vec!["mvae", "-o", "1", "2", "some"]); assert!(r.is_err()); let err = r.unwrap_err(); assert_eq!(err.kind(), ErrorKind::UnknownArgument); } #[test] fn require_delims() { let r = Command::new("mvae") .arg( arg!(o: -o "some opt") .multiple_values(true) .use_value_delimiter(true) .require_value_delimiter(true), ) .arg(arg!([file] "some file")) .try_get_matches_from(vec!["", "-o", "1,2", "some"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["1", "2"] ); assert!(m.is_present("file")); assert_eq!( m.get_one::("file").map(|v| v.as_str()).unwrap(), "some" ); } #[test] fn leading_hyphen_pass() { let r = Command::new("mvae") .arg( arg!(o: -o "some opt") .multiple_values(true) .allow_hyphen_values(true), ) .try_get_matches_from(vec!["", "-o", "-2", "3"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["-2", "3"] ); } #[test] fn leading_hyphen_fail() { let r = Command::new("mvae") .arg(arg!(o: -o "some opt")) .try_get_matches_from(vec!["", "-o", "-2"]); assert!(r.is_err()); let m = r.unwrap_err(); assert_eq!(m.kind(), ErrorKind::UnknownArgument); } #[test] fn leading_hyphen_with_flag_after() { let r = Command::new("mvae") .arg( arg!(o: -o "some opt") .multiple_values(true) .allow_hyphen_values(true), ) .arg(arg!(f: -f "some flag")) .try_get_matches_from(vec!["", "-o", "-2", "-f"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["-2", "-f"] ); assert!(!m.is_present("f")); } #[test] fn leading_hyphen_with_flag_before() { let r = Command::new("mvae") .arg(arg!(o: -o [opt] ... "some opt").allow_hyphen_values(true)) .arg(arg!(f: -f "some flag")) .try_get_matches_from(vec!["", "-f", "-o", "-2"]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["-2"] ); assert!(m.is_present("f")); } #[test] fn leading_hyphen_with_only_pos_follows() { let r = Command::new("mvae") .arg( arg!(o: -o [opt] ... "some opt") .number_of_values(1) .takes_value(true) .allow_hyphen_values(true), ) .arg(arg!([arg] "some arg")) .try_get_matches_from(vec!["", "-o", "-2", "--", "val"]); assert!(r.is_ok(), "{:?}", r); let m = r.unwrap(); assert!(m.is_present("o")); assert_eq!( m.get_many::("o") .unwrap() .map(|v| v.as_str()) .collect::>(), &["-2"] ); assert_eq!(m.get_one::("arg").map(|v| v.as_str()), Some("val")); } #[test] #[cfg(feature = "suggestions")] fn did_you_mean() { utils::assert_output(utils::complex_app(), "clap-test --optio=foo", DYM, true); } #[test] fn issue_1047_min_zero_vals_default_val() { let m = Command::new("foo") .arg( Arg::new("del") .short('d') .long("del") .takes_value(true) .require_equals(true) .min_values(0) .default_missing_value("default"), ) .try_get_matches_from(vec!["foo", "-d"]) .unwrap(); assert_eq!(m.occurrences_of("del"), 1); assert_eq!( m.get_one::("del").map(|v| v.as_str()), Some("default") ); } fn issue_1105_setup(argv: Vec<&'static str>) -> Result { Command::new("opts") .arg(arg!(-o --option "some option")) .arg(arg!(--flag "some flag")) .try_get_matches_from(argv) } #[test] fn issue_1105_empty_value_long_fail() { let r = issue_1105_setup(vec!["cmd", "--option", "--flag"]); assert!(r.is_err()); assert_eq!(r.unwrap_err().kind(), ErrorKind::EmptyValue); } #[test] fn issue_1105_empty_value_long_explicit() { let r = issue_1105_setup(vec!["cmd", "--option", ""]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert_eq!(m.get_one::("option").map(|v| v.as_str()), Some("")); } #[test] fn issue_1105_empty_value_long_equals() { let r = issue_1105_setup(vec!["cmd", "--option="]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert_eq!(m.get_one::("option").map(|v| v.as_str()), Some("")); } #[test] fn issue_1105_empty_value_short_fail() { let r = issue_1105_setup(vec!["cmd", "-o", "--flag"]); assert!(r.is_err()); assert_eq!(r.unwrap_err().kind(), ErrorKind::EmptyValue); } #[test] fn issue_1105_empty_value_short_explicit() { let r = issue_1105_setup(vec!["cmd", "-o", ""]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert_eq!(m.get_one::("option").map(|v| v.as_str()), Some("")); } #[test] fn issue_1105_empty_value_short_equals() { let r = issue_1105_setup(vec!["cmd", "-o="]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert_eq!(m.get_one::("option").map(|v| v.as_str()), Some("")); } #[test] fn issue_1105_empty_value_short_explicit_no_space() { let r = issue_1105_setup(vec!["cmd", "-o", ""]); assert!(r.is_ok(), "{}", r.unwrap_err()); let m = r.unwrap(); assert_eq!(m.get_one::("option").map(|v| v.as_str()), Some("")); } #[test] #[cfg(feature = "suggestions")] fn issue_1073_suboptimal_flag_suggestion() { let cmd = Command::new("ripgrep-616") .arg(Arg::new("files-with-matches").long("files-with-matches")) .arg(Arg::new("files-without-match").long("files-without-match")); utils::assert_output( cmd, "ripgrep-616 --files-without-matches", DYM_ISSUE_1073, true, ); } #[test] fn short_non_ascii_no_space() { let matches = Command::new("cmd") .arg(arg!(opt: -'磨' )) .try_get_matches_from(&["test", "-磨VALUE"]) .unwrap(); assert_eq!( "VALUE", matches .get_one::("opt") .map(|v| v.as_str()) .unwrap() ); } #[test] fn short_eq_val_starts_with_eq() { let matches = Command::new("cmd") .arg(arg!(opt: -f )) .try_get_matches_from(&["test", "-f==value"]) .unwrap(); assert_eq!( "=value", matches .get_one::("opt") .map(|v| v.as_str()) .unwrap() ); } #[test] fn long_eq_val_starts_with_eq() { let matches = Command::new("cmd") .arg(arg!(opt: --foo )) .try_get_matches_from(&["test", "--foo==value"]) .unwrap(); assert_eq!( "=value", matches .get_one::("opt") .map(|v| v.as_str()) .unwrap() ); } #[test] fn issue_2022_get_flags_misuse() { let cmd = Command::new("test") .next_help_heading(Some("test")) .arg(Arg::new("a").long("a").default_value("32")); let matches = cmd.try_get_matches_from(&[""]).unwrap(); assert!(matches.get_one::("a").map(|v| v.as_str()).is_some()) } #[test] fn issue_2279() { let before_help_heading = Command::new("cmd") .arg(Arg::new("foo").short('f').default_value("bar")) .next_help_heading(Some("This causes default_value to be ignored")) .try_get_matches_from(&[""]) .unwrap(); assert_eq!( before_help_heading .get_one::("foo") .map(|v| v.as_str()), Some("bar") ); let after_help_heading = Command::new("cmd") .next_help_heading(Some("This causes default_value to be ignored")) .arg(Arg::new("foo").short('f').default_value("bar")) .try_get_matches_from(&[""]) .unwrap(); assert_eq!( after_help_heading .get_one::("foo") .map(|v| v.as_str()), Some("bar") ); } #[test] fn infer_long_arg() { let cmd = Command::new("test") .infer_long_args(true) .arg(Arg::new("racetrack").long("racetrack").alias("autobahn")) .arg(Arg::new("racecar").long("racecar").takes_value(true)); let matches = cmd .clone() .try_get_matches_from(&["test", "--racec=hello"]) .unwrap(); assert!(!matches.is_present("racetrack")); assert_eq!( matches.get_one::("racecar").map(|v| v.as_str()), Some("hello") ); let matches = cmd .clone() .try_get_matches_from(&["test", "--racet"]) .unwrap(); assert!(matches.is_present("racetrack")); assert_eq!( matches.get_one::("racecar").map(|v| v.as_str()), None ); let matches = cmd .clone() .try_get_matches_from(&["test", "--auto"]) .unwrap(); assert!(matches.is_present("racetrack")); assert_eq!( matches.get_one::("racecar").map(|v| v.as_str()), None ); let cmd = Command::new("test") .infer_long_args(true) .arg(Arg::new("arg").long("arg")); let matches = cmd.clone().try_get_matches_from(&["test", "--"]).unwrap(); assert!(!matches.is_present("arg")); let matches = cmd.clone().try_get_matches_from(&["test", "--a"]).unwrap(); assert!(matches.is_present("arg")); }