llman 0.0.78

A tool for managing LLM application rules(prompts) ...
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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

#[derive(Debug, Clone, PartialEq, Eq, thiserror::Error)]
pub enum SplitShellArgsError {
    #[error("unclosed single quote")]
    UnclosedSingleQuote,
    #[error("unclosed double quote")]
    UnclosedDoubleQuote,
    #[error("trailing escape (\\)")]
    TrailingEscape,
}

/// Split a command-line string into argv-like tokens using simple shell-like rules.
///
/// Supported:
/// - Whitespace separates arguments (outside of quotes)
/// - Single quotes (`'...'`) preserve content literally (no escaping)
/// - Double quotes (`\"...\"`) preserve content; backslash escapes the next character
/// - Backslash (`\\`) escapes the next character (outside quotes and in double quotes)
///
/// Errors:
/// - Unclosed single/double quotes
/// - Trailing backslash escape
pub fn split_shell_args(input: &str) -> Result<Vec<String>, SplitShellArgsError> {
    #[derive(Debug, Clone, Copy, PartialEq, Eq)]
    enum Mode {
        Normal,
        Single,
        Double,
    }

    let mut mode = Mode::Normal;
    let mut args = Vec::new();
    let mut current = String::new();
    let mut in_token = false;
    let mut chars = input.chars().peekable();

    while let Some(ch) = chars.next() {
        match mode {
            Mode::Normal => {
                if ch.is_whitespace() {
                    if in_token {
                        args.push(std::mem::take(&mut current));
                        in_token = false;
                    }
                    continue;
                }

                in_token = true;
                match ch {
                    '\'' => mode = Mode::Single,
                    '"' => mode = Mode::Double,
                    '\\' => match chars.next() {
                        Some(next) => current.push(next),
                        None => return Err(SplitShellArgsError::TrailingEscape),
                    },
                    _ => current.push(ch),
                }
            }
            Mode::Single => match ch {
                '\'' => mode = Mode::Normal,
                _ => current.push(ch),
            },
            Mode::Double => match ch {
                '"' => mode = Mode::Normal,
                '\\' => match chars.next() {
                    Some(next) => current.push(next),
                    None => return Err(SplitShellArgsError::TrailingEscape),
                },
                _ => current.push(ch),
            },
        }
    }

    match mode {
        Mode::Normal => {}
        Mode::Single => return Err(SplitShellArgsError::UnclosedSingleQuote),
        Mode::Double => return Err(SplitShellArgsError::UnclosedDoubleQuote),
    }

    if in_token {
        args.push(current);
    }

    Ok(args)
}

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

    #[test]
    fn split_shell_args_basic_whitespace() {
        let args = split_shell_args("a  b\tc").expect("parse");
        assert_eq!(args, vec!["a", "b", "c"]);
    }

    #[test]
    fn split_shell_args_double_quotes() {
        let args = split_shell_args("--message \"hello world\" --flag").expect("parse");
        assert_eq!(args, vec!["--message", "hello world", "--flag"]);
    }

    #[test]
    fn split_shell_args_single_quotes() {
        let args = split_shell_args("--message 'hello world'").expect("parse");
        assert_eq!(args, vec!["--message", "hello world"]);
    }

    #[test]
    fn split_shell_args_backslash_escapes() {
        let args = split_shell_args("hello\\ world").expect("parse");
        assert_eq!(args, vec!["hello world"]);

        let args = split_shell_args("\"a\\\"b\"").expect("parse");
        assert_eq!(args, vec!["a\"b"]);

        let args = split_shell_args("path\\\\name").expect("parse");
        assert_eq!(args, vec!["path\\name"]);
    }

    #[test]
    fn split_shell_args_empty_quote_creates_empty_arg() {
        let args = split_shell_args("--x \"\"").expect("parse");
        assert_eq!(args, vec!["--x", ""]);
    }

    #[test]
    fn split_shell_args_unclosed_quotes_error() {
        assert_eq!(
            split_shell_args("'unclosed").unwrap_err(),
            SplitShellArgsError::UnclosedSingleQuote
        );
        assert_eq!(
            split_shell_args("\"unclosed").unwrap_err(),
            SplitShellArgsError::UnclosedDoubleQuote
        );
    }

    #[test]
    fn split_shell_args_trailing_escape_error() {
        assert_eq!(
            split_shell_args("oops\\").unwrap_err(),
            SplitShellArgsError::TrailingEscape
        );
        assert_eq!(
            split_shell_args("\"oops\\").unwrap_err(),
            SplitShellArgsError::TrailingEscape
        );
    }
}