mirror of
https://github.com/clap-rs/clap
synced 2024-12-14 06:42: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
32 lines
1,002 B
Rust
32 lines
1,002 B
Rust
//! How to use environment variable fallback an how it
|
|
//! interacts with `default_value`.
|
|
|
|
use clap::{ArgSettings, Parser};
|
|
|
|
/// Example for allowing to specify options via environment variables.
|
|
#[derive(Parser, Debug)]
|
|
#[clap(name = "env")]
|
|
struct Opt {
|
|
// Use `env` to enable specifying the option with an environment
|
|
// variable. Command line arguments take precedence over env.
|
|
/// URL for the API server
|
|
#[clap(long, env = "API_URL")]
|
|
api_url: String,
|
|
|
|
// The default value is used if neither argument nor environment
|
|
// variable is specified.
|
|
/// Number of retries
|
|
#[clap(long, env = "RETRIES", default_value = "5")]
|
|
retries: u32,
|
|
|
|
// If an environment variable contains a sensitive value, it can be hidden
|
|
// from the help screen with a special setting.
|
|
/// Secret token
|
|
#[clap(long, env = "SECRET_TOKEN", setting = ArgSettings::HideEnvValues)]
|
|
token: String,
|
|
}
|
|
|
|
fn main() {
|
|
let opt = Opt::parse();
|
|
println!("{:#?}", opt);
|
|
}
|