gotest.tools

A collection of packages to augment testing and support common patterns.

Usage

With Go modules enabled (go1.11+)

$ go get gotest.tools/v3

import "gotest.tools/v3/assert"

To use gotest.tools with an older version of Go that does not understand Go module paths pin to version v2.3.0.

Packages

• assert - compare values and fail the test when a comparison fails
• env - test code which uses environment variables
• fs - create temporary files and compare a filesystem tree to an expected value
• golden - compare large multi-line strings against values frozen in golden files
• icmd - execute binaries and test the output
• poll - test asynchronous code by polling until a desired state is reached
• skip - skip a test and print the source code of the condition used to skip the test

Related

• gotest.tools/gotestsum - go test runner with custom output
• go testing patterns - zero-depedency patterns for organizing test cases
• test doubles and patching - zero-depdency test doubles (fakes, spies, stubs, and mocks) and monkey patching patterns

Contributing

See CONTRIBUTING.md.