Buildkite Test Collector for Rust (Beta)

官方Rust适配器，用于Buildkite测试分析，实现了Rust JSON测试输出的解析器和发送器。

📦 支持的CI系统： Buildkite、GitHub Actions、CircleCI以及其他通过BUILDKITE_ANALYTICS_*环境变量。

👉 安装

1. 创建测试套件，并复制它提供的API令牌。

2. 安装buildkite-test-collector crate

cargo install buildkite-test-collector

或者您可以直接从仓库安装

cargo install --git https://github.com/buildkite/test-collector-rust buildkite-test-collector

3. 配置您的环境

将BUILDKITE_ANALYTICS_TOKEN环境变量设置为包含分析项目设置提供的令牌。

我们尝试根据存在的环境变量检测几个常见的CI环境。如果检测失败，则应用程序将因错误而崩溃。要强制使用“通用CI环境”，请将CI环境变量设置为任何非空值。

3. 将您的测试输出更改为JSON格式

在您的持续集成环境中，您需要将输出格式更改为 JSON 并添加 --report-time 以在输出中包含执行时间。遗憾的是，这些选项目前对于Rust来说是不稳定的，因此需要一些额外的命令行选项。一旦您获得了JSON输出，您可以直接将其通过 buildkite-test-collector 二进制文件 - 输入的JSON将回显到STDOUT，这样您仍然可以对其进行操作（如果需要的话）。

cargo test -- -Z unstable-options --format json --report-time | buildkite-test-collector

4. 确认正确操作

验证运行是否可在Buildkite分析仪表板上看到

🔜 路线图

查看GitHub 'enhancement' issues 了解计划中的功能。我们始终欢迎拉取请求，如果您选择贡献，我们将提供反馈和指导 💚

⚒ 开发

在克隆仓库后，运行测试

cargo test

开发收集器的有用资源包括Buildkite Test Analytics文档 和 RSpec和Minitest收集器。

👩‍💻 贡献

欢迎在GitHub上提交https://github.com/buildkite/test-collector-rust上的错误报告和拉取请求

🚀 发布

增加代码版本，标记并推送

cargo install cargo-bump
cargo bump --git-tag
git push && git push --tags

发布到Cargo注册表

cargo publish

创建新的GitHub发行版

open "https://github.com/buildkite/test-collector-rust/releases"

📜 许可证

此软件包作为开源软件根据MIT许可证条款提供。

🤙 感谢

感谢Alembic团队构建和维护此软件包。