SuperAPI AI 工具集

rust-clap

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:为使用 clap 构建 Rust CLI 应用提供最佳实践指南,适用于设计新 CLI、为现有 CLI 添加参数或子命令、校验与解析命令行输入、编写集成测试、改进帮助文本与用户体验。共 42 条规则,分 8 类并按影响优先级排序:类型驱动设计(CRITICAL)、Derive API 模式(CRITICAL)、参数配置(HIGH)、验证与解析(HIGH)、子命令架构(MEDIUM-HIGH)、帮助与文档(MEDIUM)、错误处理(MEDIUM)、测试模式(LOW-MEDIUM)。

主要能力:类型驱动设计建议用 ValueEnum 处理枚举参数、Option 表示真正可选项、PathBuf 表示文件系统参数、Vec 表示多值参数、newtype 表示语义区分、bool 表示简单标志;Derive API 建议用 derive(Parser) 作为入口、Command 属性描述元数据、Subcommand 派生表示层级、Args 派生复用参数组、文档注释生成帮助、Global 传递跨子命令选项、版本传播;参数配置含默认值、环境变量回退、短长选项、互斥、依赖、值名称;验证与解析含 value_parser、PossibleValuesParser、FromStr、try_parse、num_args;子命令架构含嵌套层级、结构体参数、必需子命令、ArgGroup、外部子命令;帮助与文档含 shell 补全、next_help_heading、after_help、隐藏高级选项;错误处理含退出码、上下文、拼写建议、彩色样式;测试含 assert_cmd、predicates、assert_fs、parse_from、trycmd。

使用方式:按需阅读 references/_sections.md 了解分类结构与影响等级,参照 assets/templates/_template.md 添加新规则;具体解释与代码示例见各参考文件;metadata.json 含版本与引用信息。

限制:资料未提供具体 clap 版本要求、安装命令、许可证及收费信息,暂未提供。