mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 14:52: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
35 lines
839 B
Rust
35 lines
839 B
Rust
//! `git.rs` serves as a demonstration of how to use subcommands,
|
|
//! as well as a demonstration of adding documentation to subcommands.
|
|
//! Documentation can be added either through doc comments or
|
|
//! `help`/`about` attributes.
|
|
|
|
use clap::Parser;
|
|
|
|
#[derive(Parser, Debug)]
|
|
#[clap(name = "git")]
|
|
/// the stupid content tracker
|
|
enum Opt {
|
|
/// fetch branches from remote repository
|
|
Fetch {
|
|
#[clap(long)]
|
|
dry_run: bool,
|
|
#[clap(long)]
|
|
all: bool,
|
|
#[clap(default_value = "origin")]
|
|
repository: String,
|
|
},
|
|
#[clap(override_help = "add files to the staging area")]
|
|
Add {
|
|
#[clap(short)]
|
|
interactive: bool,
|
|
#[clap(short)]
|
|
all: bool,
|
|
files: Vec<String>,
|
|
},
|
|
}
|
|
|
|
fn main() {
|
|
let matches = Opt::parse();
|
|
|
|
println!("{:?}", matches);
|
|
}
|