tests

Documentation

Overview

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 GoTool() (string, error)
• func GoToolPath(t *testing.T) string
• func HasExec() bool
• func HasExternalNetwork() bool
• func HasGoBuild() bool
• func HasGoRun() bool
• func HasLink() bool
• func HasSrc() bool
• func HasSymlink() bool
• func MustHaveCGO(t *testing.T)
• func MustHaveExec(t *testing.T)
• func MustHaveExternalNetwork(t *testing.T)
• func MustHaveGoBuild(t *testing.T)
• func MustHaveGoRun(t *testing.T)
• func MustHaveLink(t *testing.T)
• func MustHaveSymlink(t *testing.T)
• func NewLoggingConn(baseName string, c net.Conn) net.Conn
• func NewTestTimeoutHandler(handler Handler, ch <-chan time.Time) Handler
• func ResetCachedEnvironment()
• func ResetProxyEnv()
• func SkipFlaky(t *testing.T, issue int)
• func SkipFlakyNet(t *testing.T)
• type RecordingJar
  • func (j *RecordingJar) Cookies(u *url.URL) []*cli.Cookie
  • func (j *RecordingJar) SetCookies(u *url.URL, cookies []*cli.Cookie)
• type TestJar
  • func (j *TestJar) Cookies(u *url.URL) []*cli.Cookie
  • func (j *TestJar) SetCookies(u *url.URL, cookies []*cli.Cookie)

Variables

var (
	UniqNameMu   sync.Mutex
	UniqNameNext = make(map[string]int)
)

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 GoTool

func GoTool() (string, error)

GoTool reports the path to the Go tool.

func GoToolPath

func GoToolPath(t *testing.T) 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 HasExec

func HasExec() bool

HasExec reports whether the current system can start new processes using os.StartProcess or (more commonly) exec.Command.

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 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 MustHaveCGO

func MustHaveCGO(t *testing.T)

MustHaveCGO calls t.Skip if cgo is not available.

func MustHaveExec

func MustHaveExec(t *testing.T)

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.

func MustHaveExternalNetwork

func MustHaveExternalNetwork(t *testing.T)

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.T)

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.T)

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.T)

MustHaveLink reports whether the current system can use os.Link. If not, MustHaveLink calls t.Skip with an explanation.

func MustHaveSymlink

func MustHaveSymlink(t *testing.T)

MustHaveSymlink reports whether the current system can use os.Symlink. If not, MustHaveSymlink calls t.Skip with an explanation.

func NewLoggingConn

func NewLoggingConn(baseName string, c net.Conn) net.Conn

func NewTestTimeoutHandler

func NewTestTimeoutHandler(handler Handler, ch <-chan time.Time) Handler

func ResetCachedEnvironment

func ResetCachedEnvironment()

func ResetProxyEnv

func ResetProxyEnv()

func SkipFlaky

func SkipFlaky(t *testing.T, issue int)

func SkipFlakyNet

func SkipFlakyNet(t *testing.T)

Types

type RecordingJar

type RecordingJar struct {
	// contains filtered or unexported fields
}

RecordingJar keeps a log of calls made to it, without tracking any cookies.

func (*RecordingJar) Cookies

func (j *RecordingJar) Cookies(u *url.URL) []*cli.Cookie

func (*RecordingJar) SetCookies

func (j *RecordingJar) SetCookies(u *url.URL, cookies []*cli.Cookie)

type TestJar

type TestJar struct {
	// contains filtered or unexported fields
}

Just enough correctness for our redirect tests. Uses the URL.Host as the scope of all cookies.

func (*TestJar) Cookies

func (j *TestJar) Cookies(u *url.URL) []*cli.Cookie

func (*TestJar) SetCookies

func (j *TestJar) SetCookies(u *url.URL, cookies []*cli.Cookie)