Skip to main content

appcore-args

Independently published package

Stable 1.0.2 · MSRV Rust 1.89 · crates.io · docs.rs · source

Crate-owned guide and examples​

The public repository maintains the detailed guide, basic example, and intermediate example.

Responsibility: declarative CLI specifications, bounded argument ingestion, deterministic parsing, help rendering and shell completion.

Direct AppCore dependencies: None. This is a standalone crate with its own SemVer line.

Primary API: CliSpec, CommandSpec, OptionSpec, ArgumentSpec, ValueType, RawArgs, HelpRenderer, CompletionEngine and render_dynamic_completion_script.

Every specification is validated before parsing, help, or completion. Default input limits are 1,024 words, 64 KiB per word, and 1 MiB total; non-UTF-8 and NUL input fails closed. Optional values use attached syntax by default, avoiding ambiguous consumption of the next positional. Detached optional values require an explicit opt-in.

Dynamic completion supports Bash, Zsh, Fish, and PowerShell. Suggestions are bounded to 128-byte inputs and candidates.

Maturity: independently versioned public CLI foundation.