4 releases

0.0.3 Aug 14, 2022
0.0.2 Oct 11, 2018
0.0.1 Oct 11, 2018
0.0.0 Oct 11, 2018

#2057 in Command line utilities


250 lines

sbg - CLI Boilerplate Generator

build status

The s in sbg was for StructOpt, but that is now deprecated, but I would like to keep the name for now.

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

anyhow = "1"
url = "2"

version = "3"
features = ["derive"]

This is not flexible, and only supports a tiny subset of what 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


Assuming you have the Rust toolchain installed:

cargo install sbg

NOTE: minimum required rustc is v1.58, due to serde-yaml requiring it.


Licensed under either of

at your option.


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.


~129K SLoC