6 releases

0.2.0 Jan 30, 2023
0.1.4 Aug 31, 2022

#477 in Debugging

Download history 177/week @ 2024-03-11 202/week @ 2024-03-18 82/week @ 2024-03-25 101/week @ 2024-04-01 94/week @ 2024-04-08 55/week @ 2024-04-15 132/week @ 2024-04-22 424/week @ 2024-04-29 82/week @ 2024-05-06 198/week @ 2024-05-13 284/week @ 2024-05-20 61/week @ 2024-05-27 113/week @ 2024-06-03 62/week @ 2024-06-10 63/week @ 2024-06-17 91/week @ 2024-06-24

335 downloads per month

MIT license

24KB
316 lines

rustyrepl

The easy Rust Read-Evaluate-Print-Loop (REPL) utility crate

github crates.io docs.rs CI/main

About

rustyrepl is a simple crate to facilitate creation of Read, Evaluate, Print, Loop utilities at the command-line. A unique combination of rustyline and clap to build a simple REPL interface with handy argument parsing.

Purpose

  1. Capturing exits/quits of the REPL interface
  2. Storing and managing REPL history commands as well as an index of said commands for you
  3. Allowing operators to get a help menu at any point, using the full Clap supported help interface (i.e. sub-command help as well)
  4. 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 [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
}

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

Dependencies

~6MB
~108K SLoC