#structopt #clap #proc-macro #cli

clickrs

Simplified CLIs for Rust via procedural macros (Python's click, for Rust)

6 releases

0.1.5 Oct 18, 2021
0.1.4 Oct 17, 2021

#810 in Command-line interface

Apache-2.0 OR MIT

9KB

Click-rs

A Rust clone of Python's click, built on the structopt crate.

Documentation

Find it on Docs.rs.

Example

Unfortunately, for the time being, structopt must also be installed. Re-implementing the example from structopt, add clickrs to your dependencies of your Cargo.toml:

[dependencies]
clickrs = "0.1"
structopt = "0.3"

And then, in your rust file:

use clickrs::command;
use std::path::PathBuf;

#[command(name = "basic")]
#[argument("debug", short, long)]
#[argument("verbose", short, long, parse(from_occurrences))]
#[argument("speed", short, long, default_value = "42")]
#[argument("output", short, long, parse(from_os_str))]
#[argument("nb_cars", short = "c", long)]
#[argument("level", short, long)]
#[argument("files", name = "FILE", parse(from_os_str))]
fn main(
    debug: bool,
    verbose: u8,
    speed: f64,
    output: PathBuf,
    nb_cars: Option<i32>,
    level: Vec<String>,
    files: Vec<PathBuf>,
) {
    println!("{:?}", speed);
}

Using this example:

$ ./basic
error: The following required arguments were not provided:
    --output <output>

USAGE:
    clickrs --output <output> --speed <speed>

For more information try --help
$ ./basic --help
basic 0.1.0

USAGE:
    clickrs [FLAGS] [OPTIONS] --output <output> [--] [FILE]...

FLAGS:
    -d, --debug
    -h, --help       Prints help information
    -V, --version    Prints version information
    -v, --verbose

OPTIONS:
    -l, --level <level>...
    -c, --nb-cars <nb-cars>
    -o, --output <output>
    -s, --speed <speed>         [default: 42]

ARGS:
    <FILE>...

License

Licensed under either of

at your option.

Dependencies

~3.5MB
~58K SLoC