Struct CommandLineParser 

pub struct CommandLineParser;

Shell-like parser used by the completion engine.

Implementations

impl CommandLineParser

pub fn tokenize(&self, line: &str) -> Vec<String>

Tokenizes a line using shell-like quoting rules.

Tokenization is intentionally permissive for interactive use. If the user is mid-quote while pressing tab, we retry with a synthetic closing quote before finally falling back to whitespace splitting.

Examples

use osp_cli::completion::CommandLineParser;

let parser = CommandLineParser;

assert_eq!(
    parser.tokenize(r#"ldap user "alice smith""#),
    vec!["ldap", "user", "alice smith"]
);

pub fn tokenize_with_spans(&self, line: &str) -> Vec<TokenSpan>

Tokenizes line and preserves byte spans for each token when possible.

Examples

use osp_cli::completion::CommandLineParser;

let spans = CommandLineParser.tokenize_with_spans("ldap user alice");

assert_eq!(spans[0].value, "ldap");
assert_eq!(spans[1].start, 5);
assert_eq!(spans[2].end, 15);

pub fn analyze(&self, line: &str, cursor: usize) -> ParsedCursorLine

Parse the full line and the cursor-local prefix from one lexical walk.

The common case keeps completion analysis in one tokenization pass. If the line ends in an unmatched quote we fall back to the permissive tokenization path so interactive behavior stays unchanged.

cursor is clamped to the input length and to a valid UTF-8 character boundary before the parser slices the line.

Examples

use osp_cli::completion::CommandLineParser;

let parsed = CommandLineParser.analyze("ldap user ali", 13);

assert_eq!(parsed.parsed.cursor_tokens, vec!["ldap", "user", "ali"]);
assert_eq!(parsed.cursor.token_stub, "ali");

pub fn parse(&self, tokens: &[String]) -> CommandLine

Parses tokens into command-path, flag, positional, and pipe segments.

Examples

use osp_cli::completion::CommandLineParser;

let tokens = vec![
    "ldap".to_string(),
    "user".to_string(),
    "--json".to_string(),
    "|".to_string(),
    "P".to_string(),
];
let parsed = CommandLineParser.parse(&tokens);

assert_eq!(parsed.head(), &["ldap".to_string(), "user".to_string()]);
assert!(parsed.has_pipe());

pub fn cursor_state( &self, text_before_cursor: &str, safe_cursor: usize, ) -> CursorState

Computes the cursor replacement range and current token stub.

Examples

use osp_cli::completion::CommandLineParser;

let cursor = CommandLineParser.cursor_state("ldap user ali", 13);

assert_eq!(cursor.token_stub, "ali");
assert_eq!(cursor.replace_range, 10..13);

pub fn compute_stub_quote(&self, text_before_cursor: &str) -> Option<QuoteStyle>

Returns the active quote style for the token being edited, if any.

Examples

use osp_cli::completion::{CommandLineParser, QuoteStyle};

assert_eq!(
    CommandLineParser.compute_stub_quote(r#"ldap user "ali"#),
    Some(QuoteStyle::Double)
);

Trait Implementations

impl Clone for CommandLineParser

fn clone(&self) -> CommandLineParser

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CommandLineParser

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CommandLineParser

fn default() -> CommandLineParser

Returns the “default value” for a type.