bpaf 0.7.7

A simple Command Line Argument Parser with parser combinators
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

<details>
<summary style="display: list-item;">Combinatoric usage</summary>

```no_run
# use bpaf::*;
#[derive(Debug, Clone)]
# #[allow(dead_code)]
pub struct Options {
    version: Option<usize>,
    feature: Option<String>,
}
pub fn options() -> OptionParser<Options> {
    let version = long("version").argument("VERS").optional();
    let feature = long("feature").argument("FEAT").optional();
    construct!(Options { version, feature }).to_options()
}
```

</details>
<details>
<summary style="display: list-item;">Derive usage</summary>

```no_run
# use bpaf::*;
#[derive(Debug, Clone, Bpaf)]
#[bpaf(options)]
# #[allow(dead_code)]
pub struct Options {
    #[bpaf(argument("VERS"))]
    version: Option<usize>,
    #[bpaf(argument("FEAT"))]
    feature: Option<String>,
}
```

</details>
<details>
<summary style="display: list-item;">Examples</summary>


Missing arguments are turned into None
```console
% app 
Options { version: None, feature: None }
```

Present values are Some
[`optional`](Parser::optional)
```console
% app --version 10
Options { version: Some(10), feature: None }
```

You can specify both
```console
% app --version 10 --feature feat
Options { version: Some(10), feature: Some("feat") }
```

bpaf encases optional arguments in usage with []
```console
% app --help
Usage: [--version VERS] [--feature FEAT]

Available options:
        --version <VERS>
        --feature <FEAT>
    -h, --help            Prints help information
```

</details>