go2xunit 技术文档

1. 安装指南

go2xunit 是一个将 Go 测试输出转换为 xunit 或 xunit.net 兼容的 XML 输出的工具，常用于 Jenkins 或 Hudson 等持续集成系统。以下是安装 go2xunit 的步骤：

go get github.com/tebeka/go2xunit

2. 项目使用说明

go2xunit 默认从标准输入读取数据，并将 XML 输出到标准输出。但是，您可以使用 -input 和 -output 参数来更改这些设置。

以下是一些使用示例：

• 转换 go test 输出：

2>&1 go test -v | go2xunit -output tests.xml

• 转换 gocheck 测试输出：

2>&1 go test -gocheck.vv | go2xunit -gocheck -output tests.xml

• 在 Jenkins/Hudson 中使用示例脚本：

#!/bin/bash

outfile=gotest.out

2>&1 go test -v | tee $outfile
go2xunit -fail -input $outfile -output tests.xml

3. 项目API使用文档

go2xunit 提供以下命令行参数：

• -input: 指定输入文件的路径。
• -output: 指定输出文件的路径。
• -fail: 如果有失败的测试，则 go2xunit 会以非零状态退出。
• -gocheck: 指定使用 gocheck 测试框架。

4. 项目安装方式

go2xunit 的安装方式非常简单，您只需运行以下命令：

go get github.com/tebeka/go2xunit

这将安装 go2xunit 到您的 Go 工作环境中，您可以随时在命令行中使用它。

请注意，该项目目前处于休眠状态，作者 Miki Tebeka 可能会在将来投入时间进行维护，但目前没有计划。如果您需要替代品，可以查看 go-gunit-report。