clap/examples/tutorial_derive/05_01_assert.rs

use clap::Parser;

#[derive(Parser)]
#[clap(author, version, about, long_about = None)]
struct Cli {
    /// Network port to use
    #[clap(value_parser)]
    port: u16,
}

fn main() {
    let cli = Cli::parse();

    println!("PORT = {}", cli.port);
}

#[test]
fn verify_app() {
    use clap::CommandFactory;
    Cli::command().debug_assert()
}
docs(tutorial): Encourage `App::debug_assert` 2021-12-23 14:41:52 +00:00			`use clap::Parser;`

			`#[derive(Parser)]`
docs(examples): Steer people to know about about vs long_about `#[clap(about)]` only overrides `about`. If the doc comment also sets `long_about`, it won't be overridden. This change is to help raise visibility of reseting `long_about` in these cases. 2022-01-11 00:47:20 +00:00			`#[clap(author, version, about, long_about = None)]`
docs(tutorial): Encourage `App::debug_assert` 2021-12-23 14:41:52 +00:00			`struct Cli {`
			`/// Network port to use`
doc(derive): Update for value_parser 2022-05-21 00:52:04 +00:00			`#[clap(value_parser)]`
			`port: u16,`
docs(tutorial): Encourage `App::debug_assert` 2021-12-23 14:41:52 +00:00			`}`

			`fn main() {`
			`let cli = Cli::parse();`

			`println!("PORT = {}", cli.port);`
			`}`

			`#[test]`
			`fn verify_app() {`
fix: Rename IntoApp to CommandFactory This is part of the `App` rename. Previously, I was concerned about not being able to deprecate For backwards compatibility, we still expose the `IntoApp` name. 2022-02-14 22:09:38 +00:00			`use clap::CommandFactory;`
fix: Update derive->Command function name No good solution for transitioning the trate name, unfortnately, since we can't mark `use`s as deprecated (we can, it just does nothing). I got rid of the `into` prefix because that implies a `self` parameter that doesn't exist. 2022-02-14 22:04:07 +00:00			`Cli::command().debug_assert()`
docs(tutorial): Encourage `App::debug_assert` 2021-12-23 14:41:52 +00:00			`}`