Struct CommandRegistry 

pub struct CommandRegistry { /* private fields */ }

Registry of named commands.

Commands registered here are used by handle_pipeline and handle_parallel to dispatch each stage of a pipeline.

Examples

use wasi_shell::{CommandRegistry, handle_pipeline, IoContext};
use std::io::{self, Write};

let mut reg = CommandRegistry::with_builtins();

// Add a custom command
reg.register("greet", |args, ctx| {
    let name = args.get(1).map(|s| s.as_str()).unwrap_or("world");
    writeln!(ctx.stdout, "Hello, {}!", name).map_err(|e| e.to_string())
});

handle_pipeline("greet Rust", Box::new(io::empty()), Box::new(io::stdout()), &reg, wasibox_core::CancellationToken::new()).unwrap();

Implementations

impl CommandRegistry

pub fn new() -> Self

Create an empty registry with a wasibox_core fallback.

Any command name not explicitly registered will be forwarded to wasibox_core::execute_with_context.

pub fn with_builtins() -> Self

Create a registry pre-loaded with shell built-in commands (cd, help, exit, sl) and a wasibox_core fallback for all core utilities (echo, cat, grep, seq, head, …).

pub fn command_names(&self) -> Vec<&str>

Returns the names of all explicitly registered commands (excluding the fallback).

pub fn register<F>(&mut self, name: impl Into<String>, handler: F)

where F: Fn(&[String], &mut IoContext) -> Result<(), String> + Send + Sync + 'static,

Register (or replace) a command.

pub fn set_fallback<F>(&mut self, handler: F)

where F: Fn(&[String], &mut IoContext) -> Result<(), String> + Send + Sync + 'static,

Set a fallback handler invoked when no explicit command matches.

pub fn remove_fallback(&mut self)

Remove the fallback handler. Unknown commands will return an error.

pub fn execute( &self, args: &[String], ctx: &mut IoContext, ) -> Result<(), String>

Look up and execute a command.

Trait Implementations

impl Default for CommandRegistry

fn default() -> Self

Returns the “default value” for a type.