tradingSystem/scripts/AGENTS.md

2.6 KiB
Raw Permalink Blame History

测试与运维脚本规则

本文件适用于scripts/;其他目录修改代码时,按根规则来此查测试入口。

单测隔离

  • run_tests.py逐批调用unit_test_guard.py,清除业务环境变量,在无.env的临时目录运行并阻断套接字。只跑一批也必须走同一隔离入口;新增可直接运行的测试沿用现有安装护栏方式。
  • 新增服务调用需补test_wiring.py中的install_fakes或对应内存桩;真实连接尝试即失败,不能靠业务层吞异常让测试通过。
  • 新增test_batch*.py同时登记run_tests.py的SUITES和例数说明。缺失测试文件必须失败,不能当跳过。
  • DDL、调度、API、密钥、动作求值顺序及仓储签名变化,检查run_tests.py顶部哨兵位置清单及实际断言,不照抄历史表数或测试总数。
  • 合并分支时检查测试文件是否重名,不能让一批测试覆盖另一批;缺项不能靠删登记解决。
  • 跨边界修复至少保留一个经过真实入口和真实输出编码的反例,只替换外部I/O。桩保留实际响应包装、Decimal/日期、空值、失败返回和版本字段;不要把待核验的序列化、路由或任务入口一起替换掉。涉及异步动作按影响选择迟到、重放、部分完成和恢复场景,并检查原来允许的正常路径。

开发机在安装了项目依赖的独立虚拟环境中、从仓库根目录执行:

python scripts/run_tests.py
python scripts/unit_test_guard.py scripts/test_batch48_units.py

全量预期末行为ALL SUITES PASS。单批编号按改动选择,不固定只跑微盘。纯文档修改不要求全量回归。页面三道护栏由全量入口覆盖,也可分别经隔离入口运行。

运行脚本

make help是命令目录,不能把每个目标都当只读探针。make test用于部署服务器,发布前还须对匹配的候选镜像断网验证,步骤见pms-release。

新脚本应区分只读检查和实际写入,并验证重复执行及失败后的状态。tick、回放、建表、清账和重建账本都有业务副作用,不在活跃交易账户上当作普通单测。隔离演练使用独立数据库与前缀,不使用会认领真实成交的shadow路径。历史探针文件和文档中的日期不自动构成今天的执行授权。

历史准备与任务回执的只读导出、自动判定见业务证据核验工具。失败返回非零退出码;无显式错误不代表业务完成。工具不会触发业务任务,也没有安装定时调度。