appcore-args 1.0.1-rc.8

Bounded cross-platform argument parsing, help and completion for AppCore executables
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

use crate::{ArgumentSpec, CliSpec, CommandSpec, OptionSpec};

#[test]
fn rejects_duplicate_command_aliases() {
    let spec = CliSpec::new("demo")
        .command(CommandSpec::new("run").alias("start"))
        .command(CommandSpec::new("start"));
    assert!(spec
        .validate()
        .unwrap_err()
        .to_string()
        .contains("duplicate command or alias"));
}

#[test]
fn rejects_non_terminal_variadic_argument() {
    let spec = CliSpec::new("demo")
        .argument(ArgumentSpec::new("files").multiple(true))
        .argument(ArgumentSpec::new("out"));
    assert!(spec
        .validate()
        .unwrap_err()
        .to_string()
        .contains("must be last"));
}

#[test]
fn rejects_unknown_option_relationship() {
    let spec = CliSpec::new("demo").option(OptionSpec::flag("json").requires("output"));
    assert!(spec
        .validate()
        .unwrap_err()
        .to_string()
        .contains("unknown or self option"));
}

#[test]
fn rejects_an_option_that_shadows_an_inherited_option() {
    let spec = CliSpec::new("demo")
        .option(OptionSpec::flag("verbose").short('v'))
        .command(CommandSpec::new("run").option(OptionSpec::flag("verbose")));
    assert!(spec
        .validate()
        .unwrap_err()
        .to_string()
        .contains("duplicate option"));
}