testenv

Documentation

Overview

Package testenv contains helper functions for skipping tests based on which tools are present in the environment.

Index

• func Deadline(t Testing) (time.Time, bool)
• func ExitIfSmallMachine()
• func Go1Point() int
• func NeedsGo1Point(t Testing, x int)
• func NeedsGoBuild(t Testing)
• func NeedsGoPackages(t Testing)
• func NeedsGoPackagesEnv(t Testing, env []string)
• func NeedsTool(t Testing, tool string)
• func SkipAfterGo1Point(t Testing, x int)
• type Testing

Functions

func Deadline

func Deadline(t Testing) (time.Time, bool)

Deadline returns the deadline of t, if known, using the Deadline method added in Go 1.15.

func ExitIfSmallMachine

func ExitIfSmallMachine()

ExitIfSmallMachine emits a helpful diagnostic and calls os.Exit(0) if the current machine is a builder known to have scarce resources.

It should be called from within a TestMain function.

func Go1Point

func Go1Point() int

Go1Point returns the x in Go 1.x.

func NeedsGo1Point

func NeedsGo1Point(t Testing, x int)

NeedsGo1Point skips t if the Go version used to run the test is older than 1.x.

func NeedsGoBuild

func NeedsGoBuild(t Testing)

NeedsGoBuild skips t if the current system can't build programs with “go build” and then run them with os.StartProcess or exec.Command. android, and darwin/arm systems don't have the userspace go build needs to run, and js/wasm doesn't support running subprocesses.

func NeedsGoPackages

func NeedsGoPackages(t Testing)

NeedsGoPackages skips t if the go/packages driver (or 'go' tool) implied by the current process environment is not present in the path.

func NeedsGoPackagesEnv

func NeedsGoPackagesEnv(t Testing, env []string)

NeedsGoPackagesEnv skips t if the go/packages driver (or 'go' tool) implied by env is not present in the path.

func NeedsTool

func NeedsTool(t Testing, tool string)

NeedsTool skips t if the named tool is not present in the path. As a special case, "cgo" means "go" is present and can compile cgo programs.

func SkipAfterGo1Point

func SkipAfterGo1Point(t Testing, x int)

SkipAfterGo1Point skips t if the Go version used to run the test is newer than 1.x.

Types

type Testing

type Testing interface {
	Skipf(format string, args ...interface{})
	Fatalf(format string, args ...interface{})
}

Testing is an abstraction of a *testing.T.