bijux-cli 0.4.1

Command-line runtime for automation, plugin-driven tools, and interactive workflows with structured output.
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

#![forbid(unsafe_code)]
//! Canonical command catalog for normalization and route recognition.

use crate::contracts::canonical_bijux_tool_namespace;

fn contains(values: &[&str], value: &str) -> bool {
    values.contains(&value)
}

/// Canonical CLI root aliases supported by route normalization.
#[must_use]
pub fn cli_root_aliases() -> &'static [&'static str] {
    super::model::CLI_ROOT_ALIASES
}

/// Canonical `cli config` subcommands supported by route normalization.
#[must_use]
pub fn cli_config_subcommands() -> &'static [&'static str] {
    super::model::CLI_CONFIG_SUBCOMMANDS
}

/// Canonical `cli plugins` subcommands supported by route normalization.
#[must_use]
pub fn cli_plugins_subcommands() -> &'static [&'static str] {
    super::model::CLI_PLUGINS_SUBCOMMANDS
}

/// Normalize path aliases into canonical command paths.
#[must_use]
pub fn normalize_command_path(path: &[String]) -> Vec<String> {
    match path {
        [a, rest @ ..] if canonical_bijux_tool_namespace(a).is_some() => {
            let mut normalized = vec![canonical_bijux_tool_namespace(a)
                .expect("checked canonical namespace")
                .to_string()];
            normalized.extend(rest.iter().cloned());
            normalized
        }
        [a] if contains(super::model::CLI_ROOT_ALIASES, a) => vec!["cli".to_string(), a.clone()],
        [a, b] if a == "config" && contains(super::model::CLI_CONFIG_SUBCOMMANDS, b) => {
            vec!["cli".to_string(), "config".to_string(), b.clone()]
        }
        [a, b] if a == "plugins" && contains(super::model::CLI_PLUGINS_SUBCOMMANDS, b) => {
            vec!["cli".to_string(), "plugins".to_string(), b.clone()]
        }
        _ => path.to_vec(),
    }
}

/// Return true when normalized path is a known built-in command route.
#[must_use]
pub fn is_known_route(path: &[String]) -> bool {
    super::model::is_known_route(path)
}

/// REPL reference commands rendered in command help.
#[must_use]
pub fn repl_reference_commands() -> &'static [&'static str] {
    super::model::REPL_REFERENCE_COMMANDS
}