mod-cli 0.6.4

A fully customizable, feature-rich CLI framework for Rust. Define commands, prefixes, styled output, and more—built for flexibility and speed.
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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use modcli::command::Command;
use modcli::ModCli;
use std::env;

// Top-level group marker: "ops". Typically a no-op; serves as a namespace.
struct OpsGroup;
impl Command for OpsGroup {
    fn name(&self) -> &str {
        "ops"
    }
    fn help(&self) -> Option<&str> {
        Some("Parent group; see `help ops`")
    }
    fn execute(&self, _args: &[String]) {
        println!("Use: help ops  |  ops <child> ...");
    }
}

// Child requiring admin role: "ops:restart"
struct Restart;
impl Command for Restart {
    fn name(&self) -> &str {
        "ops:restart"
    }
    fn help(&self) -> Option<&str> {
        Some("Admin-only restart command")
    }
    fn required_caps(&self) -> &[&str] {
        &["role:admin"]
    }
    fn execute(&self, _args: &[String]) {
        println!("restart: OK")
    }
}

// Child requiring user:james
struct Private;
impl Command for Private {
    fn name(&self) -> &str {
        "ops:private"
    }
    fn help(&self) -> Option<&str> {
        Some("Visible only to user:james")
    }
    fn required_caps(&self) -> &[&str] {
        &["user:james"]
    }
    fn execute(&self, _args: &[String]) {
        println!("private: OK")
    }
}

fn main() {
    // Build CLI and grant capabilities from env var for demo
    // Example: MODCLI_CAPS="role:admin,user:james"
    let caps = env::var("MODCLI_CAPS").unwrap_or_default();

    let mut cli = ModCli::new();
    // Configure capabilities on the registry
    if !caps.is_empty() {
        let list = caps
            .split(',')
            .map(|s| s.trim().to_string())
            .filter(|s| !s.is_empty());
        cli.registry.set_caps(list);
    }

    // Register group and children
    cli.registry.register(Box::new(OpsGroup));
    cli.registry.register(Box::new(Restart));
    cli.registry.register(Box::new(Private));

    // Dispatch from process args
    let args: Vec<String> = std::env::args().skip(1).collect();
    cli.run(args);
}