mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 06:42:33 +00:00
61c9e6265b
For those that want the original behavior, you can usxe
`arg.help_heading(Some("FLAGS"))` on your flags. Limitations:
- This will not give you a special sort order
- This will not get a `[FLAGS]` added to usage
For templates, we removed `{unified}` and `{flags}`. To help people
catch these, a debug_assert was added.
I'm unsure but I think there might be a change in behavior in calcuating
when to show `[OPTION]` in usage. The old code only looked at
`required` while flags looked only at arg groups. We now look at both.
Ideally we'd add these in `_build` and remove special casing for
no-groups except in the sort order of groups. I feel like thats best
left for later.
This also reduced the scope of `App`s public API.
`get_*_with_no_heading` seemed a bit specialized to be in the public
API. #2853 looks at splitting it out into its own PR.
BREAKING CHANGE: Multiple
- `UnifiedHelpMessage` removed
- `{flags}` and `{unified}` are removed and will assert when present.
- `get_*_with_no_heading` removed
Fixes #2807
78 lines
1.8 KiB
Rust
78 lines
1.8 KiB
Rust
use clap::{crate_authors, crate_description, crate_name, crate_version, App, ErrorKind};
|
|
|
|
static DESCRIPTION_ONLY: &str = "prog 1
|
|
|
|
A simple to use, efficient, and full-featured Command Line Argument Parser
|
|
|
|
USAGE:
|
|
prog
|
|
|
|
OPTIONS:
|
|
-h, --help Print help information
|
|
-V, --version Print version information
|
|
";
|
|
|
|
static AUTHORS_ONLY: &str = "prog 1
|
|
|
|
Kevin K. <kbknapp@gmail.com>:Clap Maintainers
|
|
|
|
USAGE:
|
|
prog
|
|
|
|
OPTIONS:
|
|
-h, --help Print help information
|
|
-V, --version Print version information
|
|
";
|
|
|
|
#[test]
|
|
fn crate_version() {
|
|
let res = App::new("prog")
|
|
.version(crate_version!())
|
|
.try_get_matches_from(vec!["prog", "--version"]);
|
|
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind, ErrorKind::DisplayVersion);
|
|
assert_eq!(
|
|
err.to_string(),
|
|
format!("prog {}\n", env!("CARGO_PKG_VERSION"))
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn crate_description() {
|
|
let res = App::new("prog")
|
|
.version("1")
|
|
.about(crate_description!())
|
|
.try_get_matches_from(vec!["prog", "--help"]);
|
|
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind, ErrorKind::DisplayHelp);
|
|
assert_eq!(err.to_string(), DESCRIPTION_ONLY);
|
|
}
|
|
|
|
#[test]
|
|
fn crate_authors() {
|
|
let res = App::new("prog")
|
|
.version("1")
|
|
.author(crate_authors!())
|
|
.try_get_matches_from(vec!["prog", "--help"]);
|
|
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind, ErrorKind::DisplayHelp);
|
|
assert_eq!(err.to_string(), AUTHORS_ONLY);
|
|
}
|
|
|
|
#[test]
|
|
fn crate_name() {
|
|
let res = App::new(crate_name!())
|
|
.version("3.0")
|
|
.try_get_matches_from(vec!["clap", "--version"]);
|
|
|
|
assert!(res.is_err());
|
|
let err = res.unwrap_err();
|
|
assert_eq!(err.kind, ErrorKind::DisplayVersion);
|
|
assert_eq!(err.to_string(), "clap 3.0\n");
|
|
}
|