hjkl-ex 0.28.1

Ex-command registry and dispatch layer for the hjkl editor stack.
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

/// Split `input` into `(name, args)` where `name` is the leading
/// alphabetic-plus-optional-trailing-`!` prefix and `args` is the
/// remainder with leading whitespace stripped.
///
/// Examples:
/// - `"q"` → `("q", "")`
/// - `"q!"` → `("q!", "")`
/// - `"quit"` → `("quit", "")`
/// - `"q foo bar"` → `("q", "foo bar")`
/// - `"write /tmp/x"` → `("write", "/tmp/x")`
/// - `""` → `("", "")`
///
/// Range parsing is out of scope for Phase 1; the caller strips ranges before
/// handing `input` here.
pub(crate) fn split_name_args(input: &str) -> (&str, &str) {
    // Find end of alpha prefix
    let alpha_end = input
        .char_indices()
        .find(|(_, c)| !c.is_ascii_alphabetic())
        .map(|(i, _)| i)
        .unwrap_or(input.len());

    // Allow an optional trailing '!' immediately after the alpha prefix
    let name_end = if input.as_bytes().get(alpha_end) == Some(&b'!') {
        alpha_end + 1
    } else {
        alpha_end
    };

    let name = &input[..name_end];
    let rest = input[name_end..].trim_start();
    (name, rest)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn bare_q() {
        assert_eq!(split_name_args("q"), ("q", ""));
    }

    #[test]
    fn q_bang() {
        assert_eq!(split_name_args("q!"), ("q!", ""));
    }

    #[test]
    fn quit() {
        assert_eq!(split_name_args("quit"), ("quit", ""));
    }

    #[test]
    fn q_with_args() {
        assert_eq!(split_name_args("q foo bar"), ("q", "foo bar"));
    }

    #[test]
    fn leading_whitespace_not_stripped_here() {
        // The caller (try_dispatch) trims leading whitespace before calling us.
        // split_name_args itself just handles alpha prefix + optional !
        assert_eq!(split_name_args("   q  "), ("", "q  "));
    }

    #[test]
    fn empty_input() {
        assert_eq!(split_name_args(""), ("", ""));
    }

    #[test]
    fn write_path() {
        assert_eq!(split_name_args("write /tmp/x"), ("write", "/tmp/x"));
    }
}