# Install gotestsum with Homebrew, apk, apt, Nix, zypper

Human friendly go test runner. Version 1.13.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:gotestsum
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gotestsum
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add gotestsum
```

  Evidence: Alpine Linux edge package indexes: gotestsum from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install gotestsum
```

  Evidence: Debian stable package indexes: gotestsum from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- Nix (92%):

```sh
nix profile install nixpkgs#gotestsum
```

  Evidence: nixpkgs package indexes: pkgs/by-name/go/gotestsum/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install gotestsum
```

  Evidence: openSUSE Tumbleweed package metadata: gotestsum from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:gotestsum
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gotestsum>
- **Version:** 1.13.0
- **Source summary:** Human friendly go test runner
- **Homepage:** <https://github.com/gotestyourself/gotestsum>
- **Repository:** <https://github.com/gotestyourself/gotestsum>
- **Upstream docs:** <https://github.com/gotestyourself/gotestsum#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/gotestyourself/gotestsum/archive/refs/tags/v1.13.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- gotestsum (cli)
- gotestsum (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.13.0
- Local data: ok
- Upstream repository: https://github.com/gotestyourself/gotestsum
- Upstream latest detected: v1.13.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

gotestsum is a wrapper around go test -json that formats Go test output for humans while preserving machine-readable data for CI systems. It sits between the standard Go test runner and developer-facing or automation-facing reporting needs.

### Project history

The gotestyourself/gotestsum repository was created in March 2018, and its first GitHub release, v0.1, was published in May 2018. The project grew around Go's test2json stream, adding output formats, summaries, JUnit XML, JSON log capture, rerun support for failed tests, watch mode, and tooling for finding slow tests.

The README presents gotestsum as a test runner designed for both local development and CI automation. Its release notes show sustained maintenance after the 1.0 era, including support for additional output options, file-watching improvements, flaky-test reruns, CI report controls, and platform fixes.

### Adoption history

The project documents usage by large Go projects and infrastructure stacks, including Kubernetes, Moby, etcd, HashiCorp Vault, Pulumi, Grafana Loki, Telegraf, and containerd. That list reflects the tool's appeal in repositories where raw go test output is too noisy but replacing the Go test runner would be undesirable.

### How it is used

A common invocation is to run gotestsum in place of go test, pass Go test flags after --, and choose a display format such as pkgname, dots, testname, testdox, or standard-compatible modes. In CI, users often add --junitfile for test-report ingestion and --jsonfile to retain the original test2json stream for later analysis.

For local loops, gotestsum offers --watch to rerun tests after Go files change, --post-run-command for notifications or follow-up scripts, and gotestsum tool slowest for identifying expensive tests. Its design keeps go test semantics close while making the output easier to scan.

### Why package nerds care

gotestsum matters to package nerds because it is a canonical example of a CLI that wraps a standard tool without hiding it. It takes Go's structured test event stream seriously, turns it into useful terminal UX, and exports formats that CI servers already know how to consume.

### Timeline

- 2018: Repository created.
- 2018: v0.1 release published.
- 2023: v1.10.0 and v1.11.0 releases continued the 1.x line.
- 2024: v1.12.0 added work including file-watcher and output-format improvements.
- 2025: v1.13.0 release included watch-clear support and Go test attribute handling.

### Related projects

- go test -json and cmd/test2json provide the event format gotestsum consumes.
- JUnit XML consumers in CI systems are a major target for gotestsum's report output.
- gotest.tools is the broader module namespace associated with gotestsum.

### Sources

- <https://formulae.brew.sh/formula/gotestsum>
- <https://github.com/gotestyourself/gotestsum>
- <https://github.com/gotestyourself/gotestsum#readme>
- <https://github.com/gotestyourself/gotestsum/releases>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gotestsum
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - gotestsum - 1.8.2-1+b14: normalized package name match | Debian stable package indexes: gotestsum from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Feature-rich runner for go test | https://github.com/gotestyourself/gotestsum
- Nix - gotestsum: normalized package name match | nixpkgs package indexes: pkgs/by-name/go/gotestsum/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - gotestsum - 1.8.2-1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: gotestsum from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Feature-rich runner for go test | https://github.com/gotestyourself/gotestsum
- apk - gotestsum - 1.13.0-r7: normalized package name match | Alpine Linux edge package indexes: gotestsum from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Go test runner with output optimized for humans, JUnit XML for CI integration, and a summary of the test results | https://github.com/gotestyourself/gotestsum
- zypper - gotestsum - 1.13.0-1.4: normalized package name match | openSUSE Tumbleweed package metadata: gotestsum from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CLI Go test runner with output optimized for human readability | https://github.com/gotestyourself/gotestsum


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [cargo-nextest](https://www.automicvault.com/pkg/brew/cargo-nextest/) - Shares av.db curated category or tags: ci, cli, developer-tools, test-runner, testing.
- [gotests](https://www.automicvault.com/pkg/brew/gotests/) - Shares av.db curated category or tags: cli, developer-tools, go, golang, testing.
- [chart-testing](https://www.automicvault.com/pkg/brew/chart-testing/) - Shares av.db curated category or tags: ci, cli, developer-tools, testing.
- [counterfeiter](https://www.automicvault.com/pkg/brew/counterfeiter/) - Shares av.db curated category or tags: cli, developer-tools, go, testing.
- [fake-gcs-server](https://www.automicvault.com/pkg/brew/fake-gcs-server/) - Shares av.db curated category or tags: cli, developer-tools, go, testing.
- [flank](https://www.automicvault.com/pkg/brew/flank/) - Shares av.db curated category or tags: ci, cli, developer-tools, testing.
- [gor](https://www.automicvault.com/pkg/brew/gor/) - Shares av.db curated category or tags: cli, developer-tools, go, testing.
- [h2spec](https://www.automicvault.com/pkg/brew/h2spec/) - Shares av.db curated category or tags: cli, developer-tools, go, testing.
- [richgo](https://www.automicvault.com/pkg/brew/richgo/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, go, output.
- [shelltestrunner](https://www.automicvault.com/pkg/brew/shelltestrunner/) - Local metadata places this package in an adjacent workflow. Shared terms: cli, developer, developer-tools, runner, test.

## Combined YAML source

View the package source record on GitHub. [combined/gotestsum.yml](https://github.com/automic-vault/db/blob/main/combined/gotestsum.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
