Lib.rs

cargo-cogno

cargo-cogno 是一个用于运行 Cogno 测试的 Cargo 插件。它可以通过以下方式安装

$ cargo install cargo-cogno --locked

您需要将相关的 测试执行器 添加到您的项目中，并遵循 设置说明。

用法

您可以使用 --spec 标志选择要测试的规范

$ cargo cogno --spec 'spec-1234'

或同时测试多个规范

$ cargo cogno --spec 'spec-1234' --spec 'spec-1235'

您可以使用 --reporter 标志选择要使用的报告器

$ cargo cogno --spec 'spec-1234' --reporter raw

如果可用，console 报告器是默认的（它是 Cogno 测试执行器的一个可选功能）。否则，默认的是 raw 报告器。该 raw 报告器将原始测试结果以 JSON 文件的形式输出到当前目录。

您可以使用 --modifier 标志加载一个修改器配置文件

$ cargo cogno --spec 'spec-1234' --modifier modifier-spec-1234.toml

或同时加载多个修改器配置文件

$ cargo cogno --spec 'spec-1234' --spec 'spec-1235' --modifier modifier-spec-1234.toml --modifier modifier-spec-1235.toml

您可以使用 --trace 标志为 Cogno 测试执行器启用跟踪。

$ cargo cogno --spec 'spec-1234' --trace

这将在控制台打印详细的输出信息，这有助于调试问题。这对于 Cogno 测试执行器开发者非常有用。然而，如果需要，您还可以添加额外的 跟踪 信息到您的测试中，以便测试的消费者可以使用它来调试问题。

您可以在调用 cargo cogno 时传递额外的参数到 cargo run。例如，要将 --quiet 标志传递给 Cargo，您可以使用

$ cargo cogno --spec 'spec-1234' -- --quiet

任何 cargo run CLI 选项都可以指定在 -- 之后，以区分 cogno 和 run 的参数。

您可以将 cogno Cargo 插件视为项目的预处理器。实现会替换插件进程，一旦完成所需的设置，就使用 cargo run 进程。