ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Deno 如何为新 CLI 行为编写 spec 测试?

Deno 如何为新 CLI 行为编写 spec 测试? Deno 如何为新 CLI 行为编写 spec 测试【免费下载链接】denoA modern runtime for JavaScript and TypeScript.项目地址: https://gitcode.com/GitHub_Trending/de/deno当你给 Deno 加了新 flag、改了子命令行为、或者调整了报错信息之后需要一个能从命令行观察到结果、并对输出做断言的集成测试。Deno 的主集成测试就是 spec 测试它位于tests/specs/每个测试目录里的__test__.jsonc描述一次或多次deno调用框架会执行这些调用、捕获输出并与你写的期望值做匹配。只要改动可以从命令行观察到就应该为它写一个 spec 测试见 doc/testing.md。前提能构建出本地的 deno 二进制spec 测试执行的是编译出来的deno二进制所以先按 CLAUDE.md 的 Quick Start 装好依赖Rust、原生编译器、cmake、protobuf 等完整前置见.github/CONTRIBUTING.md并完成构建cargo build开发期快速迭代可以用cargo build --bin deno。第一步创建测试目录在tests/specs/下建一个有描述性的目录。实际惯例是按命令归类到类别目录下例如tests/specs/eval/eval_basic/。测试名就是目录名目录内放tests/specs/eval/eval_basic/ __test__.jsonc main.out真实的极简例子 eval_basic{ args: eval console.log(\hello\), output: main.out }同目录的main.out内容是hello即期望输出的断言文件。测试目录里按需放被测命令用到的输入文件如main.ts。第二步编写test.jsonc__test__.jsonc的完整字段定义在 tests/specs/schema.json支持三种结构见 tests/specs/README.md单步args、output直接写在顶层即上面的例子。多步steps数组每步一个对象{ tempDir: true, steps: [ { args: cache main.ts, output: cache.out }, { args: run main.ts, output: error.out, exitCode: 1 } ] }同一目录跑多个命名测试tests对象每个键是一个测试名。各步骤常用的字段schema 与 README 中均有定义args字符串按空白拆分或参数数组即deno后面的部分output期望输出的.out文件路径或内联的匹配文本exitCode期望退出码例如 env_vars_documented 里对deno --helpfull断言exitCode: 0if按平台选择性执行如linux、windows、unix、macflaky步骤最多重复 3 次直到成功envs为该测试设置的环境变量顶层tempDir: true把非测试文件复制到临时目录并在其中执行适合会生成node_modules之类产物的测试。多步/多测试结构还支持timeout每个步骤的超时秒默认 300、repeat、base等字段详见 tests/specs/schema.json。输出断言的匹配语言期望输出支持一套小的匹配语法字面字符表示精确匹配特殊标记有tests/specs/README.md、CLAUDE.md[WILDCARD]匹配任意个任意字符可跨行等价于正则的.*[WILDLINE]匹配当前行内任意个任意字符到行尾为止[WILDCHAR]匹配下一个字符[WILDCHARS(5)]匹配接下来的 5 个任意字符[UNORDERED_START]…[UNORDERED_END]中间的行按任意顺序匹配适合非确定性输出[# 示例]行内注释以[#开始、]结束。.out文件示例来自 CLAUDE.md示例结果Check file://[WILDCARD]/main.ts [WILDCARD] Successfully compiled [WILDLINE]第三步运行并验证仓库根目录的./x脚本封装了常用测试入口实现见 tools/x.ts# 按名称子串跑 spec 测试底层是 cargo test -p specs_tests --test specs -- filter ./x test-spec eval_basic # 列出所有可用的 spec 测试 ./x test-spec --list也可以用 cargo 直接按测试路径过滤tests/specs/README.md# 精确到 类别::测试名 cargo test specs::eval::eval_basic # 查看所有测试的输出注意测试会串行执行而不是并行 cargo test eval_basic -- --no-capture判断标准很直接命令以 0 退出、测试通过说明输出与期望值匹配失败时先查看测试输出与期望的差异然后输出格式是被你有意改过的更新对应的.out文件输出里包含非确定性内容路径、时间戳、乱序行改用[WILDCARD]、[WILDLINE]或[UNORDERED_START]/[UNORDERED_END]放宽匹配。这两条来自 CLAUDE.md 的 Test Failures 部分。可选编辑器里获得 schema 自动补全把下面配置加入本地.vscode/settings.jsontests/specs/README.md 给出的配置url相对于仓库根目录{ json.schemas: [{ fileMatch: [__test__.jsonc], url: ./tests/specs/schema.json }] }提交前spec 测试本身没有独立的 lint 步骤但按 doc/testing.md 的要求推送前运行tools/format.js和相应的tools/lint.js调用只改了 JS/TS 时用tools/lint.js --js。CI 会在 PR 上跑完整的 spec 套件所以本地能过./x test-spec name不代表 CI 一定过跨平台差异的行为要用if字段显式区分。【免费下载链接】denoA modern runtime for JavaScript and TypeScript.项目地址: https://gitcode.com/GitHub_Trending/de/deno创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表