shrs 0.0.6

modular library to build your own shell in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

//! This example shows how to create your own custom builtin and register it
//!
//! The example builtin will be a 'better cd' plugin, which onto of acting like normal cd, also
//! allows you to provide alias specific directories using `cd @work` syntax

use shrs::prelude::*;

fn hello_builtin(
    mut out: StateMut<OutputWriter>,
    args: &Vec<String>,
) -> ::anyhow::Result<CmdOutput> {
    if let Some(s) = args.first() {
        out.println(format!("Hello {s}"))?;
    } else {
        out.println("Hello World")?;
    }
    Ok(CmdOutput::success())
}

fn main() {
    // use Builtins::default() since it gives us some default builtins to use, rather than
    // Builtins::new() which gives us nothing
    let mut builtins = Builtins::default();

    // register our custom builtin to override the default cd
    builtins.insert("hello", hello_builtin);

    let myshell = ShellBuilder::default()
        .with_builtins(builtins)
        .build()
        .unwrap();

    myshell.run().unwrap();
}