SuperAPI AI 工具集

uv-pytest-unit-testing

测试与质量

查看项目

更新于 10-15 21:49

技能介绍

用途:面向 uv 管理的 Python 仓库(单项目或 uv 工作区)统一 pytest 的配置与执行流程,仅聚焦测试搭建与运行,不作为通用仓库初始化技能。

主要能力:先判断仓库模式——pyproject.toml 中定义 [tool.uv.workspace] 时视为工作区,否则视为单项目。提供 bootstrap 脚本完成 pytest 依赖与基线配置,脚本为 scripts/bootstrap_pytest_uv.sh,支持 --workspace-root、--package、--with-cov(显式需要 pytest-cov 时)、--dry-run。运行测试用 scripts/run_pytest_uv.sh,支持 --workspace-root 与 --package 指定工作区成员。失败排查顺序为:命令上下文、测试发现布局、marker 注册、导入路径假设。

编写建议:快测放 tests/unit,集成重的放 tests/integration;用 fixture 复用初始化且默认 function 级作用域;用 @pytest.mark.parametrize 替代手写循环;用 monkeypatch 处理环境变量与运行时依赖替换;使用 pydantic-settings 的项目优先覆盖环境变量或设置依赖,而不是改动已提交的 .env;自定义 mark 需在配置中注册以避免警告。

自动化:适合 Codex App 与 Codex CLI 非交互式运行,CLI 示例为 codex exec --full-auto --sandbox workspace-write --cd "<REPO_PATH>" "<PROMPT_BODY>"。输出约定包含 STATUS、SETUP、TEST_RESULTS、FAILURES、NEXT_STEPS。

限制与前提:所有安装与执行路径均要求 uv;--workspace-root 下必须存在 pyproject.toml;操作工作区成员时须显式指定包目标;不要进行无关代码重构。具体费用、平台支持范围等资料暂未提供。