用途:为使用 Click 框架构建 Python 命令行工具提供模板、模式与示例,覆盖从简单单命令到嵌套命令组、自定义校验器和进阶插件链式模式。
主要能力:提供 basic-cli.py、nested-commands.py、validators.py、advanced-cli.py 等模板;提供 generate-click-cli.sh、validate-click.sh、setup-click-project.sh 脚本;提供 complete-example.md、patterns.md、edge-cases.md 示例文档。核心模式包括 @click.group() 命令组、@cli.command() 子命令、@click.option 与 @click.argument 参数、嵌套组、click.Choice 与 click.IntRange 参数校验、@click.pass_context 共享状态、@click.version_option() 版本信息。
使用方式:按复杂度选择模板;生成项目运行 bash scripts/generate-click-cli.sh <project-name> <cli-type>,cli-type 为 basic、nested 或 advanced;校验运行 bash scripts/validate-click.sh <cli-file.py>。
适用场景:多命令 CLI 工具、带选项的部署脚本、配置管理 CLI、数据库迁移工具、API 测试 CLI、项目脚手架工具。
限制与要求:需 Python 3.8+、Click 8.0+(pip install click),彩色输出需 Rich(pip install rich)。其他细节暂未提供。