QuiCLI

Quickly build cool CLI apps in Rust.

Build Status Documentation License crates.io

Get started

  1. Create a new Rust binary project called "head" with cargo new --bin head.

  2. Add quicli as an dependency in your Cargo.toml:

    toml [dependencies] quicli = "0.1"

  3. Now, open up your src/main.rs. First, let's import all the good stuff:

    ```rust

    [macro_use] extern crate quicli;

    use quicli::prelude::*; ```

  4. Now, quickly write a cool CLI (it's also okay to type slowly):

    ```rust // Add cool slogan for your app here, e.g.: /// Get first n lines of a file

    [derive(Debug, StructOpt)]

    struct Cli { // Add a CLI argument --count/-n` that defaults to 3, and has this help text: /// How many lines to get #[structopt(long = "count", short = "n", default_value = "3")] count: usize, // Add a positional argument that the user has to supply: /// The file to read file: String, }

    main!({ let args = Cli::fromargs(); let data = readfile(args.file)?; data.lines().take(args.count).for_each(|line| println!("{}", line)); }); ```

  5. Give it a spin!

    1. cargo run it! Did you see a nice error?
    2. What does cargo run -- Cargo.toml show you?
    3. How about cargo run -- Cargo.toml --count=4 or cargo run -- Cargo.toml -n 2?
    4. cargo run -- --help -- how cool is that?
    5. More fun: Try --cont 4 (with the missing u).

Thanks

This is only possible because of all the awesome libraries included here:

License

Licensed under either of

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.