#clap #structopt #cli #proc-macro

macro clickrs_proc_macro

Simplified CLIs for Rust via procedural macros (Python's click, for Rust). The procedural macro crate.

6 releases

0.1.5 Oct 18, 2021
0.1.4 Oct 17, 2021

#15 in #structopt

Download history 25/week @ 2024-04-15 6/week @ 2024-04-22 13/week @ 2024-06-10 4/week @ 2024-06-24 8/week @ 2024-07-01 87/week @ 2024-07-29

87 downloads per month
Used in clickrs

Apache-2.0 OR MIT

10KB
139 lines

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 and structopt 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:
    basic --output <output> --speed <speed>

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

USAGE:
    basic [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