#console #command #cli #terminal #command-line

rusterm

Library providing a simple, quick command line interpreter for Rust projects

4 releases

0.2.2 Aug 28, 2021
0.2.1 Aug 28, 2021
0.1.6 Aug 11, 2021

#890 in Command-line interface

GPL-3.0 license

19KB
285 lines

Rusterm

docs dependency status build status

A fast and easy console library.

This provides a basic, minimal framework for making a basic command interpreter over applications.

Syntax

<command> [stringargument] ["string argument with spaces"] [33] [4.8]

Note that 33 and 4.8 are two different types, Integer and Float.

Examples

use rusterm::prelude::*;

fn main() {
    let mut command_table: HashMap<String, Command>= HashMap::new();
    command_table.insert("add".to_string(), add);
    let console = Console::new(command_table, ">> ");
    console.run_repl();
}

fn add(mut args: Arguments) -> Result<(), RustermError> {
    let mut sum = 0;
    for _ in 0..args.len() {
        let arg: i32 = args.pop_arg()?.try_into()?;
        sum += arg;
    }
    println!("{}", sum);
    Ok(())
}

Writing functions that work as commands

Every function that you write to be used in the Console must follow this signature: fn(mut args: brc::lex::Arguments) -> Result<(), brc::error::Error>. To use user-inputted arguments in your function, you must continually pop the command arguments from the args parameter, and then convert them into the type you expect. Example below:

use rusterm::prelude::*;

fn echo(mut args: Arguments) -> Result<(), RustermError> {
    let first_argument: String = args.pop_arg()?.try_into()?; // Expects a String, as per the type annotation. You can expect a f64, i32 or String.
    println!("{}", first_argument);
    Ok(())
}

Dependencies

~5–17MB
~188K SLoC