minicli 0.1.0

A tiny, dynamic CLI parser driven by simple string definitions or markdown files.
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108




// === src/lib.rs ===

use std::collections::HashMap;
use colored::*;
use regex::Regex;

pub struct Command {
    pub name: String,
    pub args: HashMap<String, Option<String>>,
    pub required: Vec<String>,
    pub optional: Vec<String>,
    pub definition: String,
}

impl Command {
    pub fn get(&self, key: &str) -> Option<&str> {
        self.args.get(key).and_then(|v| v.as_deref())
    }

    pub fn flag(&self, key: &str) -> bool {
        self.args.contains_key(key)
    }

    pub fn has(&self, key: &str) -> bool {
        self.args.contains_key(key)
    }

    pub fn is(&self, name: &str) -> bool {
        self.name == name
    }

    pub fn check_required(&self) {
        for key in &self.required {
            if !self.args.contains_key(key) {
                println!("{} {}", "Error:".red().bold(), format!("Missing required argument: --{}", key));
                println!("{}\n{}", "Usage:".green(), self.definition);
                std::process::exit(1);
            }
        }
    }
}

pub fn cli(definition: &str, handler: impl Fn(Command)) {
    let args: Vec<String> = std::env::args().skip(1).collect();

    if args.is_empty() || args.contains(&"--help".to_string()) {
        println!("{}\n{}", "Help:".bold().green(), definition);
        return;
    }

    let (required, optional) = parse_definition(definition);

    let command_name = args[0].clone();
    let mut parsed_args = HashMap::new();
    let mut iter = args.into_iter().skip(1);

    while let Some(arg) = iter.next() {
        if arg.starts_with("--") {
            if let Some((key, val)) = arg.split_once('=') {
                parsed_args.insert(key.trim_start_matches("--").to_string(), Some(val.to_string()));
            } else {
                let key = arg.trim_start_matches("--").to_string();
                if let Some(next) = iter.clone().next() {
                    if !next.starts_with("--") {
                        parsed_args.insert(key, Some(iter.next().unwrap()));
                    } else {
                        parsed_args.insert(key, None);
                    }
                } else {
                    parsed_args.insert(key, None);
                }
            }
        }
    }

    let cmd = Command {
        name: command_name,
        args: parsed_args,
        required,
        optional,
        definition: definition.to_string(),
    };

    cmd.check_required();
    handler(cmd);
}

fn parse_definition(def: &str) -> (Vec<String>, Vec<String>) {
    let req_re = Regex::new(r"--(\\w+)=<\\w+>").unwrap();
    let opt_re = Regex::new(r"\\[--(\\w+)\\]").unwrap();

    let mut required = Vec::new();
    let mut optional = Vec::new();

    for cap in req_re.captures_iter(def) {
        required.push(cap[1].to_string());
    }
    for cap in opt_re.captures_iter(def) {
        optional.push(cap[1].to_string());
    }

    (required, optional)
}