argh 0.1.19

Derive-based argument parsing optimized for code size
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use argh::FromArgs;

#[derive(FromArgs, PartialEq, Debug)]
/// Top-level command.
struct TopLevel {
    #[argh(subcommand)]
    nested: MySubCommandEnum,
}

#[derive(FromArgs, PartialEq, Debug)]
#[argh(subcommand)]
enum MySubCommandEnum {
    One(SubCommandOne),
    Two(SubCommandTwo),
}

#[derive(FromArgs, PartialEq, Debug)]
/// First subcommand.
#[argh(subcommand, name = "one", short = 'o')]
struct SubCommandOne {
    #[argh(switch)]
    /// fooey
    fooey: bool,
}

#[derive(FromArgs, PartialEq, Debug)]
/// Second subcommand.
#[argh(subcommand, name = "two")]
// No short alias for this one
struct SubCommandTwo {
    #[argh(switch)]
    /// bar
    bar: bool,
}

#[test]
fn test_short_alias_dispatch() {
    let expected = TopLevel { nested: MySubCommandEnum::One(SubCommandOne { fooey: true }) };

    // Test with full name "one"
    let actual = TopLevel::from_args(&["cmd"], &["one", "--fooey"]).expect("failed parsing 'one'");
    assert_eq!(actual, expected);

    // Test with short alias "o"
    let actual_short =
        TopLevel::from_args(&["cmd"], &["o", "--fooey"]).expect("failed parsing 'o'");
    assert_eq!(actual_short, expected);
}

#[test]
fn test_short_alias_redaction() {
    // Verify that redaction also works with short aliases
    let args = vec!["o", "--fooey"];
    let redacted = TopLevel::redact_arg_values(&["cmd"], &args).expect("redaction failed");
    // Since it's a switch, it might be kept or redacted depending on impl, but we check matching.
    // Redaction usually returns the args with values redacted. For switch there are no values.
    // We mainly want to ensure it doesn't error with "no subcommand matched".
    assert!(!redacted.is_empty());
}

#[test]
fn test_no_short_alias_for_two() {
    // "two" has no short alias, so "t" should fail (unless "t" is prefix matching? argh doesn't do prefix matching for subcommands by default I think, but let's see)
    // Actually argh requires exact match for subcommands unless strict is disabled?
    // Let's assume strict.

    let res = TopLevel::from_args(&["cmd"], &["t", "--bar"]);
    assert!(res.is_err());
}