aboutsummaryrefslogtreecommitdiff
path: root/structopt/examples/example.rs
blob: 7a9a51414db301b2eb306261a4234e844a34fc11 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
//! Somewhat complex example of usage of structopt.

use structopt::StructOpt;

#[derive(StructOpt, Debug)]
#[structopt(name = "example")]
/// An example of StructOpt usage.
struct Opt {
    // A flag, true if used in the command line.
    #[structopt(short, long)]
    /// Activate debug mode
    debug: bool,

    // An argument of type float, with a default value.
    #[structopt(short, long, default_value = "42")]
    /// Set speed
    speed: f64,

    // Needed parameter, the first on the command line.
    /// Input file
    input: String,

    // An optional parameter, will be `None` if not present on the
    // command line.
    /// Output file, stdout if not present
    output: Option<String>,

    // An optional parameter with optional value, will be `None` if
    // not present on the command line, will be `Some(None)` if no
    // argument is provided (i.e. `--log`) and will be
    // `Some(Some(String))` if argument is provided (e.g. `--log
    // log.txt`).
    #[structopt(long)]
    #[allow(clippy::option_option)]
    /// Log file, stdout if no file, no logging if not present
    log: Option<Option<String>>,

    // An optional list of values, will be `None` if not present on
    // the command line, will be `Some(vec![])` if no argument is
    // provided (i.e. `--optv`) and will be `Some(Some(String))` if
    // argument list is provided (e.g. `--optv a b c`).
    #[structopt(long)]
    optv: Option<Vec<String>>,

    // Skipped option: it won't be parsed and will be filled with the
    // default value for its type (in this case it'll be an empty string).
    #[structopt(skip)]
    skipped: String,
}

fn main() {
    let opt = Opt::from_args();
    println!("{:?}", opt);
}