README

gotest.tools

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

GoDoc CircleCI Go Reportcard

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

Documentation

Overview

Package gotesttools is a collection of packages to augment `testing` and support common patterns.

Source Files

Directories

Path Synopsis
Package assert provides assertions for comparing expected values to actual values.
Package assert provides assertions for comparing expected values to actual values.
cmd/gty-migrate-from-testify
Command gty-migrate-from-testify migrates packages from testify/assert and testify/require to gotest.tools/assert.
Command gty-migrate-from-testify migrates packages from testify/assert and testify/require to gotest.tools/assert.
cmp
Package cmp provides Comparisons for Assert and Check
Package cmp provides Comparisons for Assert and Check
opt
Package opt provides common go-cmp.Options for use with assert.DeepEqual.
Package opt provides common go-cmp.Options for use with assert.DeepEqual.
Package env provides functions to test code that read environment variables or the current working directory.
Package env provides functions to test code that read environment variables or the current working directory.
Package fs provides tools for creating temporary files, and testing the contents and structure of a directory.
Package fs provides tools for creating temporary files, and testing the contents and structure of a directory.
Package golden provides tools for comparing large mutli-line strings.
Package golden provides tools for comparing large mutli-line strings.
gotestsum module
Package icmd executes binaries and provides convenient assertions for testing the results.
Package icmd executes binaries and provides convenient assertions for testing the results.
Package poll provides tools for testing asynchronous code.
Package poll provides tools for testing asynchronous code.
Package skip provides functions for skipping a test and printing the source code of the condition used to skip the test.
Package skip provides functions for skipping a test and printing the source code of the condition used to skip the test.
x
Package x is a namespace for other packages.
Package x is a namespace for other packages.
subtest
Package subtest provides a TestContext to subtests which handles cleanup, and provides a testing.TB, and context.Context.
Package subtest provides a TestContext to subtests which handles cleanup, and provides a testing.TB, and context.Context.
internal
difflib
Package difflib is a partial port of Python difflib module.
Package difflib is a partial port of Python difflib module.