Expand description
rustyrepl is a simple read, evaluate, print, loop processor based on clap and utilizing rustyline.
You simply need to define your command structure in a clap::Parser derived struct and the processing logic, and the Repl will handle
§Purpose
- Capturing exits/quits of the REPL interface
- Storing and managing REPL history commands as well as an index of said commands for you
- Allowing operators to get a help menu at any point, using the full Clap supported help interface (i.e. sub-command help as well)
- Processing the commands as incoming
§Usage
First, add rustyrepl to your Cargo.toml file
[dependencies]
rustyrepl = "0.2"
Next:
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 [Command]
#[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
}
This small program will startup up a REPL with the prompt “>>” which you can interact with
>> 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
Structs§
- Repl
- Represents the REPL interface and processing loop