clap/examples/21_aliases.rs


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

extern crate clap;

use clap::{App, Arg, SubCommand};

fn main() {

    let matches = App::new("MyApp")
                        .subcommand(SubCommand::with_name("ls")
                                                .aliases(&["list", "dir"])
                                                .about("Adds files to myapp")
                                                .version("0.1")
                                                .author("Kevin K.")
                                                .arg(Arg::with_name("input")
                                                            .help("the file to add")
                                                            .index(1)
                                                            .required(true))
                                                )
                        .get_matches();

    // You can check if a subcommand was used like normal
    if matches.is_present("add") {
        println!("'myapp add' was run.");
    }

    // You can get the independent subcommand matches (which function exactly like App matches)
    if let Some(matches) = matches.subcommand_matches("add") {
        // Safe to use unwrap() because of the required() option
        println!("Adding file: {}", matches.value_of("input").unwrap());
    }

    // You can also match on a subcommand's name
    match matches.subcommand_name() {
        Some("add") => println!("'myapp add' was used"),
        None        => println!("No subcommand was used"),
        _           => println!("Some other subcommand was used"),
    }

    // Continued program logic goes here...
}