🦀 rusty_repl

A lightweight, modular framework for building interactive REPLs in Rust — with clean prompts, terminal isolation, and customisable input handling.

✨ Features

🖥️ Alternate screen mode — clean, isolated terminal workspace
💬 Custom prompts — easily define your own Prompt style
⚡ Input handling loop — powered by reedline
🧹 Automatic cleanup — restores cursor, title, and screen on exit
🎨 Keyword highlighting — built-in highlighter with custom color schemes
🧩 Extensible design - drop in new highlighters, prompts, or REPL logic

🚀 Quick Start

Add to your Cargo.toml:

[dependencies]
rusty_repl = "0.2.0"

Then in your project:

use rusty_repl::{Color, KeywordStyle, Repl};

fn handle_input(cmd: String) -> bool {
    match cmd.as_str() {
        "e" | "q" | "quit" | "exit" => true,
        val => {
            println!("{val}");
            false
        }
    }
}

fn main() {
    let ks = KeywordStyle::new(vec!["ls", "pwd", "cd"], Color::Green);
    let repl_manager = Repl::new("REPL", Some(ks), None);
    let _ = repl_manager.run(handle_input);
}

This opens an alternate terminal screen with a minimal prompt.

Type exit to leave the session.

🧩 Architecture

Module	Responsibility
`repl::input`	Handles user input with `reedline`
`repl::terminal`	Manages terminal (alternate screen, cursor, cleanup)
`repl::prompt`	Defines a cleaner, customisable prompt
`repl::highlighter`	Highlights configured keywords during input
`repl::style`	Configures keyword styles (colors, word list)
`repl::repl`	Connects all components into a cohesive REPL session

Top-level entrypoint:

use rusty_repl::Repl;

🔧 Future Enhancements

💾 Persistent command history
🧠 Syntax-aware input completion
🌈 Theming and multi-color highlighting

📜 License