用途:用于在 Python 项目中编写测试、修复缺陷、添加功能或修改网关层(适配器/提供方)时,获得测试架构方面的指导,而非语言风格规范。无需前置条件,技能自包含。
主要能力:提供五层防御式测试策略:第5层 smoke 业务逻辑集成测试(5%,真实系统)、第4层 logic 业务逻辑测试(70%,基于假件,占多数)、第3层 pure 纯单元测试(10%,零依赖)、第2层 real-sanity 集成健全性测试(10%,快速验证)、第1层 fake-check 假件基础设施测试(5%,验证测试替身本身可用)。核心理念是大规模用快速内存假件测试业务逻辑,少量用真实实现验证集成。
使用方式:按任务查阅对应参考文档。新增功能或修缺陷先读 quick-reference.md 再读 workflows.md;判断测试放哪读 testing-strategy.md;Python 模式读 python-specific.md;改网关接口读 gateway-architecture.md 与 workflows.md;判断依赖注入边界看 gateway-architecture.md;区分非理想状态与异常看 non-ideal-states.md;把 mock 转 fake 看 mock-to-fake-conversion.md;实现具体模式看 patterns.md;扩展网关看 advanced-extensions.md;自查看 anti-patterns.md。
适用场景:遵循 ABC/Real/Fake 模式设计网关;用构造函数注入假件;用 CliRunner 而非 subprocess 测 CLI;构建复杂场景与 dry-run 测试;将 unittest.mock 迁移为假件。
限制与原则:网关层保持轻薄,复杂度上移到业务逻辑;假件层不进行 I/O;仅网关拥有假件,其上层用真实逻辑加假网关测试;测试中不用硬编码路径,避免投机性测试与 subprocess 单元测试;改动接口需同步更新 ABC/Real/Fake 各层。具体安装命令、收费与价格信息暂未提供。