6个版本

0.2.1 2023年10月17日
0.2.0 2023年10月17日
0.1.3 2023年10月17日
0.0.1 2023年10月2日

#3#rustyline

Download history 18/week @ 2024-07-01 51/week @ 2024-07-29

每月51次下载

MIT 许可协议

18KB
307

CLIk

clik 包提供了一个简单易用的交互式CLI框架,灵感来源于 shellfish,通过新的概念,如子命令等进行了扩展!

示例

use clik::{clik_command, Command, CLI};
use rustyline::DefaultEditor;

/// This is the state we want to store and reuse for all commands
struct EchoState {
    /// We store the last number that was typed
    number: i32,
}

fn main() {
    // Create a new rustyline editor for reading in history
    let mut readline = DefaultEditor::new().unwrap();

    // Our CLI instance
    let mut cli = CLI::new(EchoState { number: 0 });

    // Add the 'echo' command to the CLI
    cli.add_command(echo_command());

    // Handle all incoming lines
    loop {
        match readline.readline(">> ") {
            Ok(line) => {
                readline.add_history_entry(&line).unwrap();

                // Handle the line using the CLI struct and respond to errors
                match cli.handle(&line) {
                    Ok(()) => {}
                    Err(e) => println!("ERROR: {e}"),
                }
            }
            Err(_) => break,
        }
    }
}

/// This is the function that gets called if the 'echo' command is met
/// The 'state' variable is the one we previously passed to the CLI::new() function
/// All the additional args can be parsed by using the `clik_command` macro,
/// but they need to implement `FromStr`.
#[clik_command(echo, "Prints out the supplied number")]
/// We can use multiple `clik_arg` attributes after the `clik_command` macro
/// to describe our arguments.
#[clik_arg(number, "The number to echo back")]
fn echo_command(state: &mut EchoState, number: i32) {
    println!("Updating number from {} to {}", state.number, number);

    state.number = number;

    Ok(())
}

可选功能

  • async - 允许异步函数和命令

依赖

~270–720KB
~17K SLoC