rustyrepl

易于使用的Rust Read-Evaluate-Print-Loop (REPL) 实用工具包

关于

rustyrepl 是一个简单的包，用于在命令行中创建读取、评估、打印、循环（REPL）实用工具。它将 rustyline 和 clap 结合起来，构建一个具有方便的参数解析的简单REPL界面。

目的

1. 捕获REPL界面的退出/退出操作
2. 存储和管理REPL历史命令以及这些命令的索引
3. 允许操作员在任何时候获取帮助菜单，使用Clap支持的完整帮助界面（即子命令帮助）
4. 处理传入的命令

用法

首先，将 rustyrepl 添加到您的 Cargo.toml 文件中

[dependencies]
rustyrepl = "0.2"

接下来

use anyhow::Result;
use clap::{Parser, Subcommand};
use rustyrepl::{Repl, ReplCommandProcessor};
/// The enum of sub-commands supported by the CLI
#[derive(Subcommand, Clone, Debug)]
pub enum Command {
    /// Execute a test command
    Test,
}
/// The general CLI, essentially a wrapper for the sub-commands [Commands]
#[derive(Parser, Clone, Debug)]
pub struct Cli {
    #[clap(subcommand)]
    command: Command,
}
#[derive(Debug)]
pub struct CliProcessor {}
#[async_trait::async_trait]
impl ReplCommandProcessor<Cli> for CliProcessor {
    fn is_quit(&self, command: &str) -> bool {
        matches!(command, "quit" | "exit")
    }
    async fn process_command(&self, command: Cli) -> Result<()> {
        match command.command {
            Command::Test => println!("A wild test appeared!"),
        }
        Ok(())
    }
}
// MAIN //
#[tokio::main]
async fn main() -> Result<()> {
    let processor: Box<dyn ReplCommandProcessor<Cli>> = Box::new(CliProcessor {});
    let mut repl = Repl::<Cli>::new(processor, None, Some(">>".to_string()))?;
    repl.process().await
}

这个小型程序将启动一个REPL，其提示符为 ">>"，您可以与之交互

>> help
The general CLI, essentially a wrapper for the sub-commands [Commands]

Usage: repl-interface <COMMAND>

Commands:
  test  Execute a test command
  help  Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help