blarg 1.0.4

A type-safe, domain sensitive, argument/option paradigm command line 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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

#[allow(unused_imports)]
use blarg::{derive::*, prelude::*, CommandLineParser, Condition, Parameter, Scalar, SubCommand};
use std::str::FromStr;

#[derive(Debug, PartialEq, Eq, Hash)]
enum FooBar {
    Foo,
    Bar,
    Baz,
}

impl std::fmt::Display for FooBar {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            FooBar::Foo => write!(f, "foo"),
            FooBar::Bar => write!(f, "bar"),
            FooBar::Baz => write!(f, "baz"),
        }
    }
}

impl FromStr for FooBar {
    type Err = String;

    fn from_str(value: &str) -> Result<Self, Self::Err> {
        match value.to_lowercase().as_str() {
            "foo" => Ok(FooBar::Foo),
            "bar" => Ok(FooBar::Bar),
            "baz" => Ok(FooBar::Baz),
            _ => Err(format!("unknown: {}", value)),
        }
    }
}

#[derive(Debug, BlargParser)]
#[blarg(initializer = initial)]
struct Parameters {
    #[blarg(
        command = (FooBar::Foo, SubFoo),
        command = (FooBar::Bar, SubBar),
        help = "make a good selection ok",
    )]
    switch: FooBar,
}

impl Parameters {
    fn initial() -> Self {
        Self {
            // Doesn't matter which we chose - this is an initial that must be overwritten (by virtue of being an argument).
            switch: FooBar::Bar,
        }
    }
}

#[derive(Debug, Default, BlargSubParser)]
#[blarg(about = "Do sub-foo type things.")]
struct SubFoo {
    value: String,
}

impl SubFoo {
    fn initial() -> Self {
        Self::default()
    }
}

#[derive(Debug, Default, BlargSubParser)]
#[blarg(about = "Do sub-bar type things.")]
struct SubBar {
    #[blarg(help = "my special value")]
    value: String,
}

impl SubBar {
    fn initial() -> Self {
        Self::default()
    }
}

fn main() {
    let (parameters, sub_foo, sub_bar): (Parameters, SubFoo, SubBar) = Parameters::blarg_parse();
    println!("{parameters:?}");
    println!("{sub_foo:?}");
    println!("{sub_bar:?}");
}