Aller au contenu principal

appcore-args

Paquet publié indépendamment

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

Guide et exemples maintenus par le crate

Le dépôt public maintient le guide détaillé, l'exemple débutant et l'exemple intermédiaire.

Responsabilité : spécifications CLI déclaratives, ingestion bornée des arguments, parsing déterministe, rendu de l'aide et complétion shell.

Dépendances AppCore directes : aucune. C'est un crate autonome avec sa propre ligne SemVer.

API principale : CliSpec, CommandSpec, OptionSpec, ArgumentSpec, ValueType, RawArgs, HelpRenderer, CompletionEngine et render_dynamic_completion_script.

Chaque spécification est validée avant parsing, aide ou complétion. Les limites par défaut sont 1 024 mots, 64 Kio par mot et 1 Mio au total ; les entrées non UTF-8 ou contenant NUL échouent fermées. Les valeurs optionnelles utilisent une syntaxe attachée par défaut afin de ne pas consommer le prochain argument positionnel de façon ambiguë. Une valeur optionnelle détachée exige un opt-in.

La complétion dynamique prend en charge Bash, Zsh, Fish et PowerShell. Les suggestions sont bornées à des entrées et candidats de 128 octets.

Maturité : fondation CLI publique avec versionnement indépendant.