SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-16 07:19

技能介绍

该技能规定本仓库中的 Python 脚本统一使用 uv 管理依赖,并采用独立脚本模式;需要外部包时用 PEP 723 内联依赖声明。资料明确禁止直接使用 pip、pipenv、poetry 或 venv,也不使用 requirements.txt 管理独立脚本依赖,不做全局包安装。

主要能力与用法:脚本 shebang 使用 #!/usr/bin/env -S uv run --quiet --script;需要第三方包时在脚本内写 # /// script 块,包含 requires-python 与 dependencies 列表,uv run 会在隔离环境中自动安装依赖,使脚本自包含、可移植。无依赖脚本可用 #!/usr/bin/env python3。常用依赖涵盖命令行(click、typer、questionary)、输出格式化(rich、tabulate)、数据处理(pyyaml、pydantic、python-dateutil)以及 HTTP 客户端(httpx、requests)。运行方式为直接执行 ./script_name.py,可附加参数。

最佳实践包括使用类型提示(Python 3.11+)、chmod +x 使脚本可执行、用 pathlib.Path 代替字符串路径、try/except 处理错误、rich 彩色输出、click 或 typer 解析命令行参数。资料还给出 CLI 工具与交互式提示两种常见模式示例,并建议简单文件操作、Git 操作或单命令包装改用 bash/fish,复杂逻辑、数据转换、API 交互和交互式 CLI 才用 Python。具体版本与限制以资料所述为准,其余信息暂未提供。