gotestsum 使用教程

1. 项目的目录结构及介绍

gotestsum/
├── cmd/
│   └── gotestsum/
│       └── main.go
├── contrib/
│   └── notify/
│       └── main.go
├── docs/
│   └── README.md
├── gotestsum/
│   ├── junitxml/
│   │   └── junitxml.go
│   ├── testjson/
│   │   ├── events.go
│   │   ├── parser.go
│   │   └── summary.go
│   └── main.go
├── .gitignore
├── .goreleaser.yml
├── .travis.yml
├── LICENSE
├── Makefile
├── README.md
└── go.mod

• cmd/: 包含主要的命令行工具 gotestsum 的入口文件。
• contrib/: 包含一些额外的贡献代码，例如通知工具 notify。
• docs/: 包含项目的文档，主要是 README.md。
• gotestsum/: 包含核心功能代码，如 junitxml 和 testjson 包。
• .gitignore: Git 忽略文件配置。
• .goreleaser.yml: Goreleaser 配置文件，用于发布二进制文件。
• .travis.yml: Travis CI 配置文件。
• LICENSE: 项目许可证。
• Makefile: 包含一些常用的 Makefile 命令。
• README.md: 项目的主要说明文档。
• go.mod: Go 模块文件。

2. 项目的启动文件介绍

项目的启动文件位于 cmd/gotestsum/main.go。这个文件是 gotestsum 命令行工具的入口点，负责解析命令行参数并调用相应的功能模块。

package main

import (
    "os"
    "gotest.tools/gotestsum/cmd"
)

func main() {
    os.Exit(cmd.Run(os.Args[1:]))
}

3. 项目的配置文件介绍

gotestsum 项目没有传统的配置文件，它的行为主要通过命令行参数来配置。以下是一些常用的命令行参数：

• --junitfile: 将测试结果写入 JUnit XML 文件。
• --jsonfile: 将测试结果写入 JSON 文件。
• --raw-command: 运行自定义命令。
• --watch: 监视文件变化并自动运行测试。

例如，要生成 JUnit XML 文件，可以使用以下命令：

gotestsum --junitfile test-results.xml

要监视文件变化并自动运行测试，可以使用以下命令：

gotestsum --watch

通过这些命令行参数，可以灵活地配置 gotestsum 的行为。