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
Expand ▾ Collapse ▴

Documentation

Overview

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

    Source Files

    View all

    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.
    format
    maint
    source