SuperAPI AI 工具集

python

编程与开发

查看项目

更新于 10-16 06:45

技能介绍

用途:覆盖现代 Python 开发流程,包括依赖管理、代码质量检查、测试与容器化部署。适用于处理 .py 文件、pyproject.toml,或用户提到 pytest 等场景。

主要能力:以 uv 作为唯一包管理工具(不使用 pip/poetry/pipenv),支持 uv init、uv add、uv sync --locked、uv run 等命令;使用 ruff 做 lint 与格式检查,ty 做类型检查,pytest 做测试并支持覆盖率;使用 Pydantic v2 处理 API I/O、配置、队列消息等外部数据边界;README 还提及 Docker 部署、异步模式与 CI/CD。

使用方式:快速流程为 uv init myproject && cd myproject,uv add requests pydantic httpx,uv add --dev pytest ruff,uv sync --locked,uv run python main.py,并以 uv run ruff check . && uv run ruff format --check . && uvx ty check && uv run pytest 做验证。提交前要求 make check 和 make test-e2e 通过,其中 make check 展开为 ruff 检查、格式检查、ty 检查和带覆盖率的 pytest。版本需实际查询确认,命令包括 python3 --version、查看 .python-version、grep pyproject.toml,以及通过 endoflife.date API 获取最新稳定版。

限制与注意:要求公共函数有类型注解、外部数据用 Pydantic、不使用裸 except;异步代码中不要在 asyncio.gather 任务间共享有状态客户端(如 SQLAlchemy AsyncSession),每个任务用工厂单独创建会话;异步函数中 CPU 密集工作需用 asyncio.to_thread,避免阻塞事件循环。详细的 Docker、CI/CD、异步与测试示例见参考资料,具体配置未在提供内容中展开。