ezcli 0.4.0

Easy CLI crate for Rust
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

#[macro_export]
/// Output documentation for your arguments. Write argument name followed by a
/// description. This macro replaces underscores in long-name argument token with
/// hyphens (e.g.: `flag!(--my_arg)`.
/// -> `"--my-arg"`)
/// ```
/// use ezcli::arg;
///
/// // Flag (boolean) arguments
/// arg!(-a, --my_arg: "Description");
/// // Option arguments
/// arg!(-a, --my_arg <VALUE>: "Description");
/// // Option arguments with specific possible values
/// arg!(-a, --my_arg [V|VAL|VALUE]: "Description");
/// ```
macro_rules! arg {
    (-$short_arg:tt: $desc:expr) => {
        println!("-{}:\n    {}", stringify!($short_arg), $desc)
    };
    (--$long_arg:tt: $desc:expr) => {
        println!("--{}:\n    {}", stringify!($long_arg).replace('_', "-"), $desc)
    };
    (-$short_arg:tt, --$long_arg:tt: $desc:expr) => {
        println!("-{}, --{}:\n    {}", stringify!($short_arg), stringify!($long_arg).replace('_', "-"), $desc)
    };

    (-$short_arg:tt <$val:tt>: $desc:expr) => {
        println!("-{} <{}>:\n    {}", stringify!($short_arg), stringify!($val), $desc)
    };
    (--$long_arg:tt <$val:tt>: $desc:expr) => {
        println!("--{} <{}>:\n    {}", stringify!($long_arg).replace('_', "-"), stringify!($val), $desc)
    };
    (-$short_arg:tt, --$long_arg:tt <$val:tt>: $desc:expr) => {
        println!("-{}, --{} <{}>:\n    {}", stringify!($short_arg), stringify!($long_arg).replace('_', "-"), stringify!($val), $desc)
    };

    (-$short_arg:tt [$( $opt_val:tt )|*]: $desc:expr) => {
        print!("-{} [", stringify!($short_arg));
        $(
            print!("{}|", stringify!($opt_val));
        )*
        print!("{}", 08 as char); // removes the trailing pipe |
        println!("]:\n    {}", $desc)
    };
    (--$long_arg:tt [$( $opt_val:tt )|*]: $desc:expr) => {
        print!("--{} [", stringify!($long_arg).replace('_', "-"));
        $(
            print!("{}|", stringify!($opt_val));
        )*
        print!("{}", 08 as char); // removes the trailing pipe |
        println!("]:\n    {}", $desc)
    };
    (-$short_arg:tt, --$long_arg:tt [$( $opt_val:tt )|*]: $desc:expr) => {
        print!("-{}, --{} [", stringify!($short_arg).replace('_', "-"), stringify!($long_arg).replace('_', "-"));
        $(
            print!("{}|", stringify!($opt_val));
        )*
        print!("{}", 08 as char); // removes the trailing pipe |
        println!("]:\n    {}", $desc)
    };
}