sbg 0.0.1

generates boilerplate for a structopt-driven cli
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

# sbg - StructOpt-driven Boilerplate Generator

[![Linux build status](https://travis-ci.org/tshepang/mrh.svg?branch=master)](https://travis-ci.org/tshepang/sbg)
[![Windows build status](https://ci.appveyor.com/api/projects/status/github/tshepang/sbg?svg=true)](https://ci.appveyor.com/project/tshepang/sbg)

You give this a yaml spec and it generates boilerplate code for you,
which compiles if you give it Cargo.toml with these contents:

```toml
[dependencies]
pretty_env_logger = "0.2"
serde_derive = "1"
structopt = "0.2"
log = "0.4"
```

I am aware that there is a macro to do this (in clap), but what the heck!
Also, this is not flexible,
and only supports a tiny subset of what structopt/clap supports.

The first time [steved] mentioned the idea to me, I felt
"meh!", but once you get to nested subcommands, it becomes unwieldy
the code you gotta write to handle that. He even went as far as
writing the code (not public), but unsatisfied by the notation,
I wrote this implementation.
My actual inspiration though is I wanted something that'd also
generate [warp] boilerplate, together with the [reqwest] code which
generates it (which also exists, but is also not public).

## Would be nice to fix

- check "type" actually has valid Rust types
- check "name" does not have spaces
- disallow having both "args" and "nested" (results in build failure),
  or support it (which would be useful for subcommands that share some
  options)
- when "type" is not specified, assume bool
- ensure no args have same name (results in build failure)
- support > 1 positional args

## Installation

Assuming you have the [Rust toolchain installed][install]):

    cargo install sbg

## License

Licensed under either of

 * Apache License, Version 2.0
   ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license
   ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.


[steved]: https://github.com/stevedonovan
[reqwest]: https://crates.io/crates/reqwest
[warp]: https://crates.io/crates/warp
[install]: https://rust-lang.org/install