mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 14:52:33 +00:00
9b23a09f7a
I see them fulfilling two roles - A form of bolding - As a callback to their placeholder in usage However, it is a bit of an unpolished look and no other CLI seems to do it. This looks a bit more proefessional. We have colored help for formatting and I think the sections relation to usage will be clear enough.
91 lines
2.3 KiB
Rust
91 lines
2.3 KiB
Rust
use clap::{error::ErrorKind, Arg, ArgAction, Command};
|
|
|
|
static HELP: &str = "prog
|
|
|
|
Usage:
|
|
prog [OPTIONS]
|
|
|
|
Options:
|
|
-a
|
|
-b
|
|
-c
|
|
-h, --help Print help information
|
|
";
|
|
|
|
static ONLY_B_ERROR: &str = "error: The following required arguments were not provided:
|
|
-c
|
|
|
|
Usage:
|
|
prog -b -c
|
|
|
|
For more information try --help
|
|
";
|
|
|
|
static ONLY_C_ERROR: &str = "error: The following required arguments were not provided:
|
|
-b
|
|
|
|
Usage:
|
|
prog -c -b
|
|
|
|
For more information try --help
|
|
";
|
|
|
|
fn cmd() -> Command {
|
|
Command::new("prog")
|
|
.arg(
|
|
Arg::new("a")
|
|
.short('a')
|
|
.action(ArgAction::SetTrue)
|
|
.required_unless_present_any(["b", "c"])
|
|
.conflicts_with_all(["b", "c"]),
|
|
)
|
|
.arg(
|
|
Arg::new("b")
|
|
.short('b')
|
|
.action(ArgAction::SetTrue)
|
|
.required_unless_present("a")
|
|
.requires("c"),
|
|
)
|
|
.arg(
|
|
Arg::new("c")
|
|
.short('c')
|
|
.action(ArgAction::SetTrue)
|
|
.required_unless_present("a")
|
|
.requires("b"),
|
|
)
|
|
}
|
|
|
|
#[test]
|
|
fn valid_cases() {
|
|
let res = cmd().try_get_matches_from(vec!["", "-a"]);
|
|
assert!(res.is_ok(), "{}", res.unwrap_err());
|
|
let res = cmd().clone().try_get_matches_from(vec!["", "-b", "-c"]);
|
|
assert!(res.is_ok(), "{}", res.unwrap_err());
|
|
let res = cmd().try_get_matches_from(vec!["", "-c", "-b"]);
|
|
assert!(res.is_ok(), "{}", res.unwrap_err());
|
|
}
|
|
|
|
#[test]
|
|
fn help_text() {
|
|
let res = cmd().try_get_matches_from(vec!["prog", "--help"]);
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind(), ErrorKind::DisplayHelp);
|
|
println!("{}", err);
|
|
assert_eq!(err.to_string(), HELP);
|
|
}
|
|
|
|
#[test]
|
|
fn no_duplicate_error() {
|
|
let res = cmd().try_get_matches_from(vec!["", "-b"]);
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind(), ErrorKind::MissingRequiredArgument);
|
|
assert_eq!(err.to_string(), ONLY_B_ERROR);
|
|
|
|
let res = cmd().try_get_matches_from(vec!["", "-c"]);
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind(), ErrorKind::MissingRequiredArgument);
|
|
assert_eq!(err.to_string(), ONLY_C_ERROR);
|
|
}
|