From 39d66182f0290bacc10886c2659874bd9edc2d4b Mon Sep 17 00:00:00 2001 From: 魏曹先生 <1992414357@qq.com> Date: Tue, 19 May 2026 22:48:23 +0800 Subject: Add `empty_result!` macro and `REPL` resource, improve examples --- examples/example-repl/Cargo.lock | 92 ++++++++++++++++++++++++ examples/example-repl/Cargo.toml | 8 +++ examples/example-repl/src/main.rs | 142 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 242 insertions(+) create mode 100644 examples/example-repl/Cargo.lock create mode 100644 examples/example-repl/Cargo.toml create mode 100644 examples/example-repl/src/main.rs (limited to 'examples/example-repl') diff --git a/examples/example-repl/Cargo.lock b/examples/example-repl/Cargo.lock new file mode 100644 index 0000000..cabbe98 --- /dev/null +++ b/examples/example-repl/Cargo.lock @@ -0,0 +1,92 @@ +# This file is automatically @generated by Cargo. +# It is not intended for manual editing. +version = 4 + +[[package]] +name = "example-repl" +version = "0.0.1" +dependencies = [ + "just_fmt", + "mingling", +] + +[[package]] +name = "just_fmt" +version = "0.1.2" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "5454cda0d57db59778608d7a47bff5b16c6705598265869fb052b657f66cf05e" + +[[package]] +name = "mingling" +version = "0.1.9" +dependencies = [ + "mingling_core", + "mingling_macros", + "size", +] + +[[package]] +name = "mingling_core" +version = "0.1.9" +dependencies = [ + "just_fmt", + "once_cell", +] + +[[package]] +name = "mingling_macros" +version = "0.1.9" +dependencies = [ + "just_fmt", + "once_cell", + "proc-macro2", + "quote", + "syn", +] + +[[package]] +name = "once_cell" +version = "1.21.4" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "9f7c3e4beb33f85d45ae3e3a1792185706c8e16d043238c593331cc7cd313b50" + +[[package]] +name = "proc-macro2" +version = "1.0.106" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934" +dependencies = [ + "unicode-ident", +] + +[[package]] +name = "quote" +version = "1.0.45" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924" +dependencies = [ + "proc-macro2", +] + +[[package]] +name = "size" +version = "0.5.0" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "1b6709c7b6754dca1311b3c73e79fcce40dd414c782c66d88e8823030093b02b" + +[[package]] +name = "syn" +version = "2.0.117" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99" +dependencies = [ + "proc-macro2", + "quote", + "unicode-ident", +] + +[[package]] +name = "unicode-ident" +version = "1.0.24" +source = "registry+https://github.com/rust-lang/crates.io-index" +checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75" diff --git a/examples/example-repl/Cargo.toml b/examples/example-repl/Cargo.toml new file mode 100644 index 0000000..34b85e3 --- /dev/null +++ b/examples/example-repl/Cargo.toml @@ -0,0 +1,8 @@ +[package] +name = "example-repl" +version = "0.0.1" +edition = "2024" + +[dependencies] +mingling = { path = "../../mingling", features = ["repl", "parser"] } +just_fmt = "0.1.2" diff --git a/examples/example-repl/src/main.rs b/examples/example-repl/src/main.rs new file mode 100644 index 0000000..2eb92e1 --- /dev/null +++ b/examples/example-repl/src/main.rs @@ -0,0 +1,142 @@ +use mingling::{REPL, hook::ProgramHook, prelude::*, this}; +use std::{env::current_dir, path::PathBuf}; + +// Resource to store the current directory +#[derive(Clone)] +struct CurrentDir { + dir: PathBuf, +} + +impl Default for CurrentDir { + fn default() -> Self { + Self { + dir: current_dir().unwrap(), + } + } +} + +fn main() { + let mut program = ThisProgram::new(); + + // Add resource + program.with_resource(CurrentDir::default()); + + // Add dispatchers + program.with_dispatcher(ChangeDirectoryCommand); + program.with_dispatcher(ListCommand); + program.with_dispatcher(ExitCommand); + + // Add hooks to handle REPL-related events + program.with_hook( + ProgramHook::empty() + .on_repl_begin(|| { + // Print welcome message + println!("Welcome!") + }) + .on_repl_pre_readline(|| { + // Print prompt + let res = this::().res::().unwrap(); + let dir_str: String = res.dir.to_string_lossy().into(); + let prompt = format!( + "{}> ", + dir_str + .replace(&['/', '\\'][..], ">") + .trim_start_matches('>') + .trim_end_matches('>') + ); + print!("{}", prompt) + }) + .on_repl_receive_result(|r| { + // Print output + if !r.is_empty() { + println!("{}", r.trim()) + } + }), + ); + + // Start the REPL loop + program.exec_repl(); +} + +// Create error route +pack!(ErrorDirectoryNotExist = PathBuf); + +// Create commands: cd ls exit +dispatcher!("cd", ChangeDirectoryCommand => ChangeDirectoryEntry); +dispatcher!("ls", ListCommand => ListEntry); +dispatcher!("exit", ExitCommand => ExitEntry); + +// Define data needed for the cd command's execution phase +pack!(StateChangeDirectory = String); + +// Define data needed for the ls command's rendering phase +pack!(ResultList = Vec); + +// Parse cd command arguments +#[chain] +fn parse_cd_args(prev: ChangeDirectoryEntry) -> Next { + let join = prev.pick(()).unpack(); + StateChangeDirectory::new(join) +} + +// Execute directory change +#[chain] +fn handle_cd(prev: StateChangeDirectory, current_dir: &mut CurrentDir) -> Next { + let join = prev.inner; + let new_dir = just_fmt::fmt_path::fmt_path(current_dir.dir.join(join)).unwrap_or_default(); + + // If the path is not found, route to error handling + if !new_dir.exists() { + return ErrorDirectoryNotExist::new(new_dir).to_render(); + } + + current_dir.dir = new_dir; + empty_result!() +} + +// Get directory contents via the CurrentDir resource +#[chain] +fn handle_ls(_prev: ListEntry, current_dir: &CurrentDir) -> Next { + let dir = ¤t_dir.dir; + let entries: Vec = std::fs::read_dir(dir) + .into_iter() + .flat_map(|rd| rd.filter_map(|e| e.ok())) + .map(|e| { + let name = e.file_name().to_string_lossy().to_string(); + if e.file_type().map(|t| t.is_dir()).unwrap_or(false) { + format!("{}/", name) + } else { + name + } + }) + .collect(); + + // Render ResultList + ResultList::new(entries).to_render() +} + +// Render ResultList data +#[renderer] +fn render_list(list: ResultList) { + for item in list.inner { + r_println!("{}", item) + } +} + +// Handle exit command event +#[chain] +fn handle_exit( + _prev: ExitEntry, + repl: &mut REPL, // Import REPL resource, registered in `exec_repl`, usable directly +) { + // Set the REPL exit flag; REPL will exit after this loop iteration + repl.exit = true; +} + +// Handle path not found event +#[renderer] +fn render_error_directory_not_exist(err: ErrorDirectoryNotExist) { + r_println!("Directory not found: {}", err.inner.display()) +} + +gen_program!(); -- cgit