10 releases
0.2.8 | Aug 31, 2023 |
---|---|
0.2.7 | Mar 6, 2023 |
0.2.6 | Oct 10, 2021 |
0.2.5 | Jun 6, 2021 |
0.1.0 | Jun 5, 2020 |
#339 in Command-line interface
321 downloads per month
Used in 4 crates
(3 directly)
43KB
793 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
~10MB
~190K SLoC