SuperAPI AI 工具集

run-puzzle-tests

测试与质量

查看项目

更新于 10-16 08:06

技能介绍

用途:在修改 jigsawR 包的 R 源码、添加新拼图类型或功能、提交前验证、调试特定失败时,运行并解读测试套件。

主要能力:支持三种测试范围。完整套件用于提交前或重大改动后,约 2-5 分钟;过滤模式用于处理某一拼图类型,约 30 秒;单文件用于调试某个测试文件,约 10 秒。可解读测试摘要行中的 PASS、FAIL、SKIP、WARN 数量。

用法:通过 WSL 执行 R。完整套件示例:cd /mnt/d/dev/p/jigsawR && "$R_EXE" -e "devtools::test()";过滤示例:"$R_EXE" -e "devtools::test(filter = 'snic')";单文件示例:"$R_EXE" -e "testthat::test_file('tests/testthat/test-snic-puzzles.R')"。R 可执行文件路径示例为 "/mnt/c/Program Files/R/R-4.5.0/bin/Rscript.exe"。

流程:选择范围、创建并执行测试脚本、解读结果、调查失败、核实跳过原因。验证标准为 FAIL=0、无异常警告、跳过数符合预期、测试数未减少。

限制与注意事项:不要使用 --vanilla,否则会破坏 renv 激活;复杂 -e 字符串可能因转义问题报 Exit code 5,应改用脚本文件;renv 报错可先运行 renv::restore();若改了影响 NAMESPACE 的代码,先运行 devtools::load_all() 或 devtools::document();部分测试依赖 Suggests 包。相关技能包括 generate-puzzle、add-puzzle-type、write-testthat-tests、validate-piles-notation。以上均依据资料,未提供的信息暂未提供。