pound 0.1.5

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
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

// SPDX-License-Identifier: EUPL-1.2

//! environment-variable fallback: the command line wins, then `env`, then
//! `default`. env is resolved by the typed readers, so it never enters the
//! borrowed `Matches`.

use pound::Parse;

#[derive(Parse)]
#[pound(name = "app")]
struct Cli {
    #[pound(long, env = "POUND_TOKEN")]
    token: Option<String>,
    #[pound(long, env = "POUND_LEVEL", default = "info")]
    level: String,
}

#[derive(Parse)]
#[pound(name = "req")]
struct Req {
    #[pound(long, env = "POUND_REQ")]
    req: String,
}

fn set(k: &str, v: &str) {
    unsafe { std::env::set_var(k, v) };
}
fn clear(k: &str) {
    unsafe { std::env::remove_var(k) };
}
const fn no_args() -> Vec<&'static str> {
    Vec::new()
}

// one test fn, so the process-global environment is only touched serially.
#[test]
fn env_fallback_precedence() {
    clear("POUND_TOKEN");
    clear("POUND_LEVEL");
    clear("POUND_REQ");

    // nothing set: the optional is None, the bare field uses its default
    let c = Cli::try_parse_from(no_args()).unwrap();
    assert_eq!(c.token, None);
    assert_eq!(c.level, "info");

    // env fills a value the command line omitted, and beats the default
    set("POUND_TOKEN", "from-env");
    set("POUND_LEVEL", "debug");
    let c = Cli::try_parse_from(no_args()).unwrap();
    assert_eq!(c.token.as_deref(), Some("from-env"));
    assert_eq!(c.level, "debug");

    // the command line beats env
    let c = Cli::try_parse_from(["--token", "cli", "--level", "trace"]).unwrap();
    assert_eq!(c.token.as_deref(), Some("cli"));
    assert_eq!(c.level, "trace");

    // env satisfies a required field, and its absence is still an error
    assert!(Req::try_parse_from(no_args()).is_err());
    set("POUND_REQ", "ok");
    assert_eq!(Req::try_parse_from(no_args()).unwrap().req, "ok");

    clear("POUND_TOKEN");
    clear("POUND_LEVEL");
    clear("POUND_REQ");
}