#repl #interpreter

repl-rs

Library to generate a REPL for your application

9 releases

0.2.7 Mar 6, 2023
0.2.6 Oct 10, 2021
0.2.5 Jun 6, 2021
0.2.4 Oct 12, 2020
0.1.0 Jun 5, 2020

#280 in Command-line interface

Download history 51/week @ 2023-02-13 29/week @ 2023-02-20 10/week @ 2023-02-27 53/week @ 2023-03-06 31/week @ 2023-03-13 20/week @ 2023-03-20 44/week @ 2023-03-27 26/week @ 2023-04-03 21/week @ 2023-04-10 22/week @ 2023-04-17 28/week @ 2023-04-24 66/week @ 2023-05-01 121/week @ 2023-05-08 142/week @ 2023-05-15 13/week @ 2023-05-22 45/week @ 2023-05-29

322 downloads per month
Used in 2 crates

MIT license

40KB
760 lines

repl-rs

Library to help you create a REPL for your application.

Basic example code:

use std::collections::HashMap;
use repl_rs::{Command, Error, Parameter, Result, Value};
use repl_rs::{Convert, Repl};

// Add two numbers.
fn add<T>(args: HashMap<String, Value>, _context: &mut T) -> Result<Option<String>> {
   let first: i32 = args["first"].convert()?;
   let second: i32 = args["second"].convert()?;

   Ok(Some((first + second).to_string()))
}

// Write "Hello"
fn hello<T>(args: HashMap<String, Value>, _context: &mut T) -> Result<Option<String>> {
   Ok(Some(format!("Hello, {}", args["who"])))
}

fn main() -> Result<()> {
   let mut repl = Repl::new(())
       .with_name("MyApp")
       .with_version("v0.1.0")
       .with_description("My very cool app")
       .add_command(
           Command::new("add", add)
               .with_parameter(Parameter::new("first").set_required(true)?)?
               .with_parameter(Parameter::new("second").set_required(true)?)?
               .with_help("Add two numbers together"),
       )
       .add_command(
            Command::new("hello", hello)
                .with_parameter(Parameter::new("who").set_required(true)?)?
                .with_help("Greetings!"),
   );
   repl.run()
}

Running the example above:

% my_app
Welcome to MyApp v0.1.0
MyApp> help
MyApp v0.1.0: My very cool app
------------------------------                              
add - Add two numbers together
hello - Greetings!
MyApp> help add
add: Add two numbers together
Usage:
        add first second
MyApp> add 1 2
3
MyApp> 

Dependencies

~6MB
~137K SLoC