wr

wr 是一个用于驱动 Rust 编写的测试驱动研讨会的 CLI 工具。
它设计用于与研讨会仓库一起使用，该仓库包含一系列研讨会参与者需要解决的问题。

[!注意] 该研讨会运行器由 Mainmatter 开发，以支持我们的 现场 Rust 研讨会。如果您正在寻找 Rust 咨询或培训，请查看我们的 着陆页！

工作原理

我不能创造的，我就不能理解。

理查德·费曼

测试驱动研讨会结构为一系列练习。
每个练习都是一个带有验证解决方案正确性的测试集的 Rust 项目。

wr 将运行当前练习的测试，如果通过，则允许您进入下一个练习，同时跟踪您已解决的问题。

您可以在 rust-telemetry-workshop 中看到它的实际应用。

安装

cargo install workshop-runner

检查是否正确安装

wr --help

使用方法

运行

wr

从研讨会仓库的最高级文件夹运行，以验证当前练习的解决方案并继续研讨会。

您也可以导航到特定的练习，然后在它的目录中运行 wr check 以验证其解决方案，无论当前练习是什么。

持续检查

您可以将 wr 与 cargo-watch 结合使用，以便在每次修改代码时重新检查您的解决方案

cargo watch -- wr

文件夹结构

wr 预期研讨会仓库具有以下结构

.
├── exercises
│  ├── 00_<collection name>
│  │  ├── 00_<exercise name>
│  │  │  ..
│  │  ├── 0n_<exercise name>
│  │  ..
│  ├── 0n_<collection name>
│  │  ├── 00_<exercise name>
│  │  │  ..
│  │  ├── 0n_<exercise name>

每个 xx_<练习名称> 文件夹必须是一个具有自己的 Cargo.toml 文件的 Rust 项目。

您可以通过在调用 wr 时传递 --exercises-dir 标志，或者创建一个包含以下内容的顶层 wr.toml 文件来选择不同的顶级文件夹名称

exercises-dir = "my-top-level-folder"

您可以参考 rust-telemetry-workshop 作为示例。