dprint-development

帮助测试 Rust dprint 插件的存储库。

测试规范

此存储库提供了一个辅助函数，用于在文档中运行在文本文件中定义的测试规范（有关 API，请参阅 函数）。

这允许您按以下格式编写测试（以下 TypeScript 为例）

== description goes here ==
const    u    =     2;

[expect]
const u = 2;

有关实际示例，请参阅 dprint-plugin-typescript/tests。

更改文件名

默认情况下，使用的文件名是提供给 ParseSpecOptions 的，但您可以通过在文件顶部添加以下内容来更改每个测试规范文件中使用的默认文件名

-- file.tsx --

配置

要更改配置，请在文件顶部使用以下内容，如果提供了文件名，则在文件名下方

~~ indentWidth: 2, useTabs: true ~~

测试规范描述辅助函数

您可以通过将某些词添加到测试描述中来自定义所有测试的运行方式

• (only) - 仅运行此测试。
• (skip) - 跳过运行此测试。
• (skip-format-twice) - 跳过再次格式化输出以确保其保持不变——仅格式化一次。
• (trace) - 仅运行此测试并将 IR 图输出到 HTML 文件，以便在网页浏览器中查看。必须使用 cargo test --features tracing 运行

例如，将 (only) 添加到描述中，将只会运行本例中的第一个测试（虽然你需要使用 cargo test 来仅运行该特定测试）

== test 1 (only) ==
const    u    =     2;

[expect]
const u = 2;

== test 2 ==
console.log(  10 )

[expect]
console.log(10);

仅运行文件中的测试

注意与当前文件对应的测试名称，并使用 cargo test <测试名称> 运行

覆盖失败

有时更改可能会导致大型的测试失败（例如，将默认空格缩进从4个空格更改为2个空格）。如果您不想手动更新所有测试，可以在调用 run_specs 时指定 fix_failures: true 到 RunSpecsOptions