package testenv
import "internal/testenv"
Package testenv provides information about what functionality is available in different testing environments run by the Go team.
It is an internal package because these details are specific to the Go team's test setup (on build.golang.org) and not fundamental to tests in general.
Index
- Variables
- func Builder() string
- func CPUIsSlow() bool
- func CanInternalLink(withCgo bool) bool
- func CleanCmdEnv(cmd *exec.Cmd) *exec.Cmd
- func Command(t testing.TB, name string, args ...string) *exec.Cmd
- func CommandContext(t testing.TB, ctx context.Context, name string, args ...string) *exec.Cmd
- func GOROOT(t testing.TB) string
- func GoTool() (string, error)
- func GoToolPath(t testing.TB) string
- func HasCGO() bool
- func HasExternalNetwork() bool
- func HasGoBuild() bool
- func HasGoRun() bool
- func HasLink() bool
- func HasParallelism() bool
- func HasSrc() bool
- func HasSymlink() bool
- func MustHaveBuildMode(t testing.TB, buildmode string)
- func MustHaveCGO(t testing.TB)
- func MustHaveExec(t testing.TB)
- func MustHaveExecPath(t testing.TB, path string)
- func MustHaveExternalNetwork(t testing.TB)
- func MustHaveGoBuild(t testing.TB)
- func MustHaveGoRun(t testing.TB)
- func MustHaveLink(t testing.TB)
- func MustHaveParallelism(t testing.TB)
- func MustHaveSymlink(t testing.TB)
- func MustInternalLink(t testing.TB, withCgo bool)
- func OptimizationOff() bool
- func SkipFlaky(t testing.TB, issue int)
- func SkipFlakyNet(t testing.TB)
- func SkipIfOptimizationOff(t testing.TB)
- func SkipIfShortAndSlow(t testing.TB)
- func SyscallIsNotSupported(err error) bool
- func WriteImportcfg(t testing.TB, dstPath string, packageFiles map[string]string, pkgs ...string)
Variables
var Sigquit = syscall.SIGQUIT
Sigquit is the signal to send to kill a hanging subprocess. Send SIGQUIT to get a stack trace.
Functions
func Builder
func Builder() string
Builder reports the name of the builder running this test (for example, "linux-amd64" or "windows-386-gce"). If the test is not running on the build infrastructure, Builder returns the empty string.
func CPUIsSlow
func CPUIsSlow() bool
CPUIsSlow reports whether the CPU running the test is suspected to be slow.
func CanInternalLink
func CanInternalLink(withCgo bool) bool
CanInternalLink reports whether the current system can link programs with internal linking.
func CleanCmdEnv
func CleanCmdEnv(cmd *exec.Cmd) *exec.Cmd
CleanCmdEnv will fill cmd.Env with the environment, excluding certain variables that could modify the behavior of the Go tools such as GODEBUG and GOTRACEBACK.
If the caller wants to set cmd.Dir, set it before calling this function, so PWD will be set correctly in the environment.
func Command
func Command(t testing.TB, name string, args ...string) *exec.Cmd
Command is like exec.Command, but applies the same changes as testenv.CommandContext (with a default Context).
func CommandContext
func CommandContext(t testing.TB, ctx context.Context, name string, args ...string) *exec.Cmd
CommandContext is like exec.CommandContext, but:
- skips t if the platform does not support os/exec,
- sends SIGQUIT (if supported by the platform) instead of SIGKILL in its Cancel function
- if the test has a deadline, adds a Context timeout and WaitDelay for an arbitrary grace period before the test's deadline expires,
- fails the test if the command does not complete before the test's deadline, and
- sets a Cleanup function that verifies that the test did not leak a subprocess.
func GOROOT
func GOROOT(t testing.TB) string
GOROOT reports the path to the directory containing the root of the Go project source tree. This is normally equivalent to runtime.GOROOT, but works even if the test binary was built with -trimpath and cannot exec 'go env GOROOT'.
If GOROOT cannot be found, GOROOT skips t if t is non-nil, or panics otherwise.
func GoTool
func GoTool() (string, error)
GoTool reports the path to the Go tool.
func GoToolPath
func GoToolPath(t testing.TB) string
GoToolPath reports the path to the Go tool. It is a convenience wrapper around GoTool. If the tool is unavailable GoToolPath calls t.Skip. If the tool should be available and isn't, GoToolPath calls t.Fatal.
func HasCGO
func HasCGO() bool
HasCGO reports whether the current system can use cgo.
func HasExternalNetwork
func HasExternalNetwork() bool
HasExternalNetwork reports whether the current system can use external (non-localhost) networks.
func HasGoBuild
func HasGoBuild() bool
HasGoBuild reports whether the current system can build programs with “go build” and then run them with os.StartProcess or exec.Command.
func HasGoRun
func HasGoRun() bool
HasGoRun reports whether the current system can run programs with “go run”.
func HasLink
func HasLink() bool
HasLink reports whether the current system can use os.Link.
func HasParallelism
func HasParallelism() bool
HasParallelism reports whether the current system can execute multiple threads in parallel. There is a copy of this function in cmd/dist/test.go.
func HasSrc
func HasSrc() bool
HasSrc reports whether the entire source tree is available under GOROOT.
func HasSymlink
func HasSymlink() bool
HasSymlink reports whether the current system can use os.Symlink.
func MustHaveBuildMode
func MustHaveBuildMode(t testing.TB, buildmode string)
MustHaveBuildMode reports whether the current system can build programs in the given build mode. If not, MustHaveBuildMode calls t.Skip with an explanation.
func MustHaveCGO
func MustHaveCGO(t testing.TB)
MustHaveCGO calls t.Skip if cgo is not available.
func MustHaveExec
func MustHaveExec(t testing.TB)
MustHaveExec checks that the current system can start new processes using os.StartProcess or (more commonly) exec.Command. If not, MustHaveExec calls t.Skip with an explanation.
On some platforms MustHaveExec checks for exec support by re-executing the current executable, which must be a binary built by 'go test'. We intentionally do not provide a HasExec function because of the risk of inappropriate recursion in TestMain functions.
To check for exec support outside of a test, just try to exec the command. If exec is not supported, testenv.SyscallIsNotSupported will return true for the resulting error.
func MustHaveExecPath
func MustHaveExecPath(t testing.TB, path string)
MustHaveExecPath checks that the current system can start the named executable using os.StartProcess or (more commonly) exec.Command. If not, MustHaveExecPath calls t.Skip with an explanation.
func MustHaveExternalNetwork
func MustHaveExternalNetwork(t testing.TB)
MustHaveExternalNetwork checks that the current system can use external (non-localhost) networks. If not, MustHaveExternalNetwork calls t.Skip with an explanation.
func MustHaveGoBuild
func MustHaveGoBuild(t testing.TB)
MustHaveGoBuild checks that the current system can build programs with “go build” and then run them with os.StartProcess or exec.Command. If not, MustHaveGoBuild calls t.Skip with an explanation.
func MustHaveGoRun
func MustHaveGoRun(t testing.TB)
MustHaveGoRun checks that the current system can run programs with “go run”. If not, MustHaveGoRun calls t.Skip with an explanation.
func MustHaveLink
func MustHaveLink(t testing.TB)
MustHaveLink reports whether the current system can use os.Link. If not, MustHaveLink calls t.Skip with an explanation.
func MustHaveParallelism
func MustHaveParallelism(t testing.TB)
MustHaveParallelism checks that the current system can execute multiple threads in parallel. If not, MustHaveParallelism calls t.Skip with an explanation.
func MustHaveSymlink
func MustHaveSymlink(t testing.TB)
MustHaveSymlink reports whether the current system can use os.Symlink. If not, MustHaveSymlink calls t.Skip with an explanation.
func MustInternalLink
func MustInternalLink(t testing.TB, withCgo bool)
MustInternalLink checks that the current system can link programs with internal linking. If not, MustInternalLink calls t.Skip with an explanation.
func OptimizationOff
func OptimizationOff() bool
OptimizationOff reports whether optimization is disabled.
func SkipFlaky
func SkipFlaky(t testing.TB, issue int)
func SkipFlakyNet
func SkipFlakyNet(t testing.TB)
func SkipIfOptimizationOff
func SkipIfOptimizationOff(t testing.TB)
SkipIfOptimizationOff skips t if optimization is disabled.
func SkipIfShortAndSlow
func SkipIfShortAndSlow(t testing.TB)
SkipIfShortAndSlow skips t if -short is set and the CPU running the test is suspected to be slow.
(This is useful for CPU-intensive tests that otherwise complete quickly.)
func SyscallIsNotSupported
func SyscallIsNotSupported(err error) bool
SyscallIsNotSupported reports whether err may indicate that a system call is not supported by the current platform or execution environment.
func WriteImportcfg
func WriteImportcfg(t testing.TB, dstPath string, packageFiles map[string]string, pkgs ...string)
WriteImportcfg writes an importcfg file used by the compiler or linker to dstPath containing entries for the file mappings in packageFiles, as well as for the packages transitively imported by the package(s) in pkgs.
pkgs may include any package pattern that is valid to pass to 'go list', so it may also be a list of Go source files all in the same directory.