pound 0.1.4

low footprint, derive-first CLI parser
Documentation 
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

// SPDX-License-Identifier: EUPL-1.2

//! aliases: extra long names for an option, and extra names for a subcommand.
//! aliases match on the command line but stay out of help.

use pound::Parse;

#[derive(Parse)]
enum Cmd {
    #[pound(alias = "rm,del")]
    Remove { name: String },
    Status,
}

#[derive(Parse)]
#[pound(name = "app")]
struct Cli {
    #[pound(long, alias = "colour")]
    color: Option<String>,
    #[pound(subcommand)]
    cmd: Cmd,
}

#[test]
fn arg_alias_matches_like_the_primary() {
    let a = Cli::try_parse_from(["--color", "red", "status"]).unwrap();
    assert_eq!(a.color.as_deref(), Some("red"));
    let a = Cli::try_parse_from(["--colour", "blue", "status"]).unwrap();
    assert_eq!(a.color.as_deref(), Some("blue"));
}

#[test]
fn command_aliases_select_the_variant() {
    // the primary name plus both aliases all reach Remove and bind its field
    for name in ["remove", "rm", "del"] {
        let Cmd::Remove { name: got } = Cli::try_parse_from([name, "x"]).unwrap().cmd else {
            panic!("`{name}` did not select Remove");
        };
        assert_eq!(got, "x");
    }
}