shelp
(sh help
) is a library to create a functional and good looking REPL without having to worry about
the generic setup and interacting and the terminal. It provides a configurable interface,
allowing you to only need to deal with the language specific parts of the REPL.
Currently there are fixed commands:
- clear
- clears the screen
- exit
- exits
In the future, I would like to add the ability to specify custom commands.
Take some program that just prints the input back: ```rust use shelp::{Repl, Color}; let repl = Repl::newd("> ", ". ", None); let mut repl = repl.iter(Color::Green);
for command in repl {
//
Here no
LangInterfaceis specified, so the default is used.
A
LangInterface` can be specified by implementing the trait and passing it as the generic
type argument.
```rust use std::io::{self, prelude::*}; use shelp::{Repl, Color, LangInterface, Result}; // You can use any library, but currently only crossterm is used in the library for terminal. use crossterm::style::Colorize;
struct MyLangInterface; // We want to override the linting so numbers are coloured, but we don't have a specific way of // getting the indentation, so we do not override that. impl LangInterface for MyLangInterface { fn printline(: &mut io::Stdout, line: &str) -> Result<()> { for i in line.chars() { if i.is_numeric() { print!("{}", i.magenta()); } else { print!("{}", i); } } Ok(()) } }
// Use a particular capacity
let mut repl = Repl::
loop { // You can have dynamic colours if you don't use the iterator. It also allows you to use the // errors instead of them being ignored. // NOTE here it is unwrapped, but it should be dealt with in a better way. let command = repl.next(Color::Blue).unwrap();
// <Do something>
} ```