clap/clap_derive/examples/env.rs
Rémy Greinhofer 2a2cf81977 Update the env var example for derive
Updates the derive example handling environment variables to illustrate
the case where it contains a sensitive value which should not be
displayed on the help screen.

Closes https://github.com/clap-rs/clap/issues/2101
2020-08-23 18:18:25 -05:00

32 lines
998 B
Rust

//! How to use environment variable fallback an how it
//! interacts with `default_value`.
use clap::{ArgSettings, Clap};
/// Example for allowing to specify options via environment variables.
#[derive(Clap, 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);
}