unilang_instruction_parser

Alias crate for unilang_parser. Re-exports unilang_parser for backward compatibility.

overview

This crate serves as a compatibility alias for the core unilang_parser library, which provides syntactic analysis for CLI-like instruction strings within the Unilang Framework. It enables parsing of command strings into structured GenericInstruction objects.

key_features

• command_path_parsing: Multi-segment command paths (namespace.command)
• argument_processing: Both positional and named arguments (key::value)
• quoting_support: Single and double quotes with escape sequences
• help_operator: Built-in ? help request handling
• multiple_instructions: Sequence parsing with ;; separator
• robust_error_reporting: Detailed parse errors with source locations

usage

use unilang_instruction_parser::{Parser, UnilangParserOptions};

let parser = Parser::new(UnilangParserOptions::default());
let input = "log.level severity::debug message::'Hello World!'";

match parser.parse_single_instruction(input) {
    Ok(instruction) => {
        println!("Command: {:?}", instruction.command_path_slices);
        println!("Named args: {:?}", instruction.named_arguments);
    },
    Err(e) => eprintln!("Parse error: {}", e),
}

migration_notice

This is an alias crate that re-exports unilang_parser. For new projects, consider using unilang_parser directly. This crate exists to maintain backward compatibility for existing code.

documentation

For complete documentation and examples, see:

• api_documentation
• core_parser_documentation

license

MIT License. See LICENSE file for details.