mirror of
https://github.com/clap-rs/clap
synced 2024-12-15 23:32:32 +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
54 lines
1.3 KiB
Rust
54 lines
1.3 KiB
Rust
// Copyright 2018 Guillaume Pinot (@TeXitoi) <texitoi@texitoi.eu>,
|
|
// Kevin Knapp (@kbknapp) <kbknapp@gmail.com>, and
|
|
// Andrew Hobden (@hoverbear) <andrew@hoverbear.org>
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
//
|
|
// This work was derived from Structopt (https://github.com/TeXitoi/structopt)
|
|
// commit#ea76fa1b1b273e65e3b0b1046643715b49bec51f which is licensed under the
|
|
// MIT/Apache 2.0 license.
|
|
|
|
//! A test to check that clap_derive compiles with deny(missing_docs)
|
|
|
|
#![deny(missing_docs)]
|
|
|
|
use clap::Parser;
|
|
|
|
/// The options
|
|
#[derive(Parser, Debug, PartialEq)]
|
|
pub struct Opt {
|
|
#[clap(short)]
|
|
verbose: bool,
|
|
#[clap(subcommand)]
|
|
cmd: Option<Cmd>,
|
|
}
|
|
|
|
/// Some subcommands
|
|
#[derive(Parser, Debug, PartialEq)]
|
|
pub enum Cmd {
|
|
/// command A
|
|
A,
|
|
/// command B
|
|
B {
|
|
/// Alice?
|
|
#[clap(short)]
|
|
alice: bool,
|
|
},
|
|
/// command C
|
|
C(COpt),
|
|
}
|
|
|
|
/// The options for C
|
|
#[derive(Parser, Debug, PartialEq)]
|
|
pub struct COpt {
|
|
#[clap(short)]
|
|
bob: bool,
|
|
}
|
|
|
|
fn main() {
|
|
println!("{:?}", Opt::parse());
|
|
}
|