用途:在 Python 项目中搭建和编写测试时使用,提供 pytest 配置、fixture 写法、测试理念与目录结构指南。
主要理念:测试用于证明功能可用,覆盖率是次要目标;端到端测试优于单元测试,真实实现优于 mock。用 mock 掩盖被测对象本身的测试没有证明力。5 个良好的端到端测试胜过 100 个重度 mock 的单元测试,遵循 20/80 原则,在能带来最大信心的地方写测试。单元测试只用于纯逻辑,即诚实转换数据的函数;优先使用真实 HTTP 服务器(pytest-httpserver)、真实临时目录和真实进程。
测试优先级:CLI / 端到端测试(运行真实命令,检查输出和退出码);集成测试(通过公共 API 检查组件交互);单元测试(纯数据转换函数)。跳过框架胶水代码、UI 布局和无意义 getter。
配置:采用 [tool.pytest.ini_options] 设置 testpaths、python_files、asyncio_mode 与 unit/integration 标记;目录结构为 tests/ 下分 unit、integration、fixtures 及 conftest.py。
关键 fixture 模式:用 monkeypatch 和 tmp_path 构造隔离环境(如设置 XDG_CONFIG_HOME、XDG_DATA_HOME);用 httpserver 构造真实 HTTP mock 服务并返回 JSON。
运行方式:uv run poe test 运行全部;uv run pytest tests/integration/ 只跑集成测试;uv run pytest --cov 带覆盖率。更完整的模式见 guides/testing-lightweight.md,容器化测试见 guides/testing-heavyweight.md。限制:具体版本、依赖清单及完整示例配置暂未提供。