本月测试基础设施动态：2024 年 11 月

这是关于 2024 年 11 月 rust-lang/rust 仓库¹测试基础设施的变更的快速总结。 它还包括对正在进行的工作的简要描述。

像往常一样，如果您在使用我们的测试基础设施时遇到错误或用户体验问题，请提交问题。 如果我们不知道，错误和不便就无法修复！

感谢所有为我们的测试基础设施做出贡献的人！

亮点

compiletest：添加 proc-macro 辅助构建指令

@ehuss 添加了一个 //@ proc-macro 指令，其行为类似于 //@ aux-build，但它打包了之前 proc-macro 辅助工具所需的常用 //@ force-host 和 //@ no-prefer-dynamic 样板代码。 如果主测试文件也使用足够新的版本（即 2018 版或更高版本），则 proc-macro 辅助工具也可通过外部 prelude 使用。

之前：测试编写者需要为每个 proc-macro 辅助工具编写 //@ force-host 和 //@ no-prefer-dynamic。

// tests/ui/foo/my-main-test.rs
//@ aux-build: my-proc-macro.rs

// tests/ui/foo/auxiliary/my-proc-macro.rs
//@ no-prefer-dynamic
//@ force-host

之后：在主测试文件中只需要 //@ proc-macro 指令。

// tests/ui/foo/my-main-test.rs
//@ proc-macro: my-proc-macro.rs

// tests/ui/foo/auxiliary/my-proc-macro.rs

谢谢 Eric！

rustc：当设置 RUSTC_BOOTSTRAP=-1 时，使 rustc 将自身视为稳定编译器

在 #132993 中，我修改了 rustc 的稳定性检查逻辑，现在也识别 RUSTC_BOOTSTRAP=-1 以强制任何 rustc 将自身视为稳定编译器，无论它来自哪个通道（例如，beta、dev、nightly 或 stable）²。 这对于例如 nightly 和 stable 之间不同的诊断很有用，并且还提供了一种使被测 rustc 的行为如同它是稳定编译器的方式。

在测试中，//@ rustc-env 指令可以与 RUSTC_BOOTSTRAP=-1 一起使用³。

//@ rustc-env:RUSTC_BOOTSTRAP=-1
//@ compile-flags: -Z unstable-options
//@ regex-error-pattern: error: the option `Z` is only accepted on the nightly compiler
// This will fail because the `rustc` under test rejects the `-Z unstable-options` unstable flag.

PR 列表

改进

• compiletest:
  • 添加 {ignore,needs}-{rustc,std}-debug-assertions 指令支持 #131913.
  • 添加 max-llvm-major-version 指令 #132310
  • 添加 AIX run-make 支持 #132657
  • 添加 exact-llvm-major-version 指令 #132995
  • 添加 proc-macro 指令 #133540
• rustc
  • 当 RUSTC_BOOTSTRAP=-1 时，使 rustc 将自身视为稳定编译器 #132993

清理

• compiletest:
  • 删除 //@ pretty-expanded 指令 #133470

文档更新

• rustc-dev-guide:
  • 更新 //@ proc-macro 辅助构建指令文档 #2149
  • 删除 pretty-expanded，因为它不再存在 #2147
  • 添加测试错误代码文档的说明 #2145
  • 记录如何获取 cdb.exe #2137
  • 提及用于其他测试的 RUSTC_BOOTSTRAP #2136
  • 记录 exact-llvm-major-version 指令 #2135
  • 记录 max-llvm-major-version 指令 #2129
  • 重命名 {ignore,only}-debug -> {ignore,needs}-{rustc,std}-debug-assertions #2101

正在进行的工作

注意：肯定还有更多自发的努力，这更像是我知道的“计划”。

• 提出了 2025H1 项目目标：重构 compiletest 指令处理 #148

1. 此处的测试基础设施是指测试工具 compiletest 和我们在构建系统 bootstrap 中的支持组件。 此测试基础设施主要由 rustc 和 rustdoc 使用。 其他工具（如 cargo、miri 或 rustfmt）维护自己的测试基础设施。 ↩

2. 这仅用于内部测试用途。 其他任何依赖于此而发生故障的情况都将被视为 PEBKAC。 ↩

3. //@ rustc-env 指令处理存在一个错误，即它在冒号和值之间对空格敏感，因此目前请避免使用空格。 ↩