palc 0.0.2

WIP: Command Line Argument Parser with several opposite design goal from Clap
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use std::path::PathBuf;

use palc::{Args, Parser, Subcommand, ValueEnum};

/// My great App.
#[derive(Debug, PartialEq, Parser)]
struct MyCli {
    name: Option<String>,

    #[command(flatten)]
    config: Config,

    #[arg(short = 'v', global = true)]
    debug: bool,

    #[arg(long, require_equals = true)]
    color: Color,

    #[command(subcommand)]
    command: Option<Commands>,
}

/// Configure something.
#[derive(Debug, PartialEq, Args)]
struct Config {
    #[arg(long)]
    config_file: Option<PathBuf>,
    #[arg(long)]
    config: Option<String>,
}

#[derive(Debug, PartialEq, Subcommand)]
enum Commands {
    /// Do something complex
    Test {
        #[arg(short, long)]
        list: bool,

        files: Option<Vec<PathBuf>>,
    },
    Transparent(Config),
    /// Do something simple
    Unit,
}

#[derive(Debug, PartialEq, ValueEnum)]
enum Color {
    Auto,
    Never,
    Always,
}

#[test]
fn smoke() {
    let args = MyCli::try_parse_from([
        "foo",
        "--color=always",
        "--config",
        "foo",
        "bar",
        "test",
        "-l",
        "-v",
        "hello",
        "world",
    ])
    .unwrap();
    assert_eq!(
        args,
        MyCli {
            color: Color::Always,
            name: Some("bar".into()),
            config: Config { config_file: None, config: Some("foo".into()) },
            debug: true,
            command: Some(Commands::Test {
                list: true,
                files: Some(vec![PathBuf::from("hello"), PathBuf::from("world")]),
            }),
        }
    );
}

#[cfg(feature = "help")]
#[test]
fn help() {
    let help = MyCli::render_long_help("me");
    println!("{help}");

    assert!(help.contains("My great App."));
    assert!(help.contains("Usage: me --color=<COLOR> [OPTIONS]"));
}