SuperAPI AI 工具集

click

测试与质量

查看项目

更新于 10-16 00:31

技能介绍

用途:在构建命令行界面(CLI)时应用该技能,涉及命令、命令组、选项、参数与提示等场景。

主要能力与用法:单命令用 @click.command(),多命令 CLI 用 @click.group();选项用 @click.option() 声明,位置参数用 @click.argument()。每个选项和命令都应提供 help= 以自动生成帮助文本;敏感选项可用 envvar= 支持环境变量回退。用 @click.group() 与 group.add_command() 组织子命令,用 @click.pass_context 在命令组与子命令间共享状态。类型安全方面,使用内置类型如 click.Path(exists=True)、click.Choice([...])、click.IntRange(),自定义校验用回调。测试用 click.testing.CliRunner(),无需子进程开销;断言 result.exit_code 与 result.output,用 mix_stderr=False 单独测试 stderr。

限制与陷阱:不要用 sys.exit(),改用 click.exceptions.Exit 或从命令返回;不要用 print(),改用 click.echo() 以正确处理编码;始终优雅处理 KeyboardInterrupt 与中止提示。

其他信息(如版本、安装命令、平台支持)暂未提供。