SuperAPI AI 工具集

write-single-python-script

编程与开发

查看项目

更新于 10-16 04:55

技能介绍

用途:指导编写单文件 Python 脚本、自动化工具或小型实用程序,使用 PEP 722 内联元数据管理依赖,通过 uv run --script 运行。主要能力与约定:脚本以 shebang 调用 uv,内联块声明 requires-python(示例为 >=3.14)与 dependencies(示例含 typer、rusty-results,可按需添加 jinja2、pyyaml、jsonschema);代码按常量与类型、业务逻辑、CLI 界面分段,业务函数返回 Result[T, E],CLI 用 typer 构建命令并在出错时向 stderr 输出错误并以状态码 1 退出。可在脚本旁创建 pyproject.toml 仅用于 ruff 与 basedpyright 配置,不需要 [project] 段。当脚本需要生成文本输出(HTML、markdown、配置)时可使用 Jinja2 的 Environment 与 FileSystemLoader 加载同目录模板并渲染。使用限制与切换条件:需要多个源文件、需要测试、需要图形界面或行数将超过约 500 行时,应改为完整项目而非单文件脚本。CLI 方面,配合 uv 的脚本建议统一使用 typer;仅当脚本必须在无任何外部依赖(纯标准库、不用 uv)下运行时才使用 argparse。资料未提供安装命令、收费信息、性能数据或具体使用示例输出。