mirror of
https://github.com/clap-rs/clap
synced 2024-12-13 22:32:33 +00:00
d840d5650e
Before #2005, `Clap` was a special trait that derived all clap traits it detected were relevant (including an enum getting both `ArgEnum`, `Clap`, and `Subcommand`). Now, we have elevated `Clap`, `Args`, `Subcommand`, and `ArgEnum` to be user facing but the name `Clap` isn't very descriptive. This also helps further clarify the relationships so a crate providing an item to be `#[clap(flatten)]` or `#[clap(subcommand)]` is more likely to choose the needed trait to derive. Also, my proposed fix fo #2785 includes making `App` attributes almost exclusively for `Clap`. Clarifying the names/roles will help communicate this. For prior discussion, see #2583
31 lines
670 B
Rust
31 lines
670 B
Rust
//! Usage example of `arg_enum`
|
|
//!
|
|
//! All the variants of the enum and the enum itself support `rename_all`
|
|
|
|
use clap::{ArgEnum, Parser};
|
|
|
|
#[derive(ArgEnum, Debug, PartialEq, Clone)]
|
|
enum ArgChoice {
|
|
/// Descriptions are supported as doc-comment
|
|
Foo,
|
|
// Renames are supported
|
|
#[clap(name = "b-a-r")]
|
|
Bar,
|
|
// Aliases are supported
|
|
#[clap(alias = "b", alias = "z")]
|
|
Baz,
|
|
// Hiding variants from help and completion is supported
|
|
#[clap(hidden = true)]
|
|
Hidden,
|
|
}
|
|
|
|
#[derive(Parser, PartialEq, Debug)]
|
|
struct Opt {
|
|
#[clap(arg_enum)]
|
|
arg: ArgChoice,
|
|
}
|
|
|
|
fn main() {
|
|
let opt = Opt::parse();
|
|
println!("{:#?}", opt);
|
|
}
|