package testutil

import "github.com/docker/docker/testutil"

Package testutil contains common testing tasks like running dockerd.

Index ¶

• Variables
• func CheckNotParallel(t testing.TB)
• func CleanupContext(t *testing.T)
• func ConfigureTracing() func(context.Context)
• func GenerateRandomAlphaOnlyString(n int) string
• func GetContext(t TestingT) context.Context
• func RunCommand(ctx context.Context, cmd string, args ...string) *icmd.Result
• func SetContext(t TestingT, ctx context.Context)
• func StartSpan(ctx context.Context, t TestingT) context.Context
• func TempDir(t *testing.T) string
• type HelperT
• type TestingT

Variables ¶

var DevZero io.Reader = devZero{}

DevZero acts like /dev/zero but in an OS-independent fashion.

Functions ¶

func CheckNotParallel ¶

func CheckNotParallel(t testing.TB)

CheckNotParallel checks if t.Parallel() was not called on the current test. There's no public method to check this, so we use reflection to check the internal field set by t.Parallel() https://github.com/golang/go/blob/8e658eee9c7a67a8a79a8308695920ac9917566c/src/testing/testing.go#L1449

Since this is not a public API, it might change at any time.

func CleanupContext ¶

func CleanupContext(t *testing.T)

func ConfigureTracing ¶

func ConfigureTracing() func(context.Context)

ConfigureTracing sets up an OTLP tracing exporter for use in tests.

func GenerateRandomAlphaOnlyString ¶

func GenerateRandomAlphaOnlyString(n int) string

GenerateRandomAlphaOnlyString generates an alphabetical random string with length n.

func GetContext ¶

func GetContext(t TestingT) context.Context

func RunCommand ¶

func RunCommand(ctx context.Context, cmd string, args ...string) *icmd.Result

func SetContext ¶

func SetContext(t TestingT, ctx context.Context)

func StartSpan ¶

func StartSpan(ctx context.Context, t TestingT) context.Context

StartSpan starts a span for the given test.

func TempDir ¶

func TempDir(t *testing.T) string

TempDir returns a temporary directory for use in tests. t.TempDir() can't be used as the temporary directory returned by that function cannot be accessed by the fake-root user for rootless Docker. It creates a nested hierarchy of directories where the outermost has permission 0700.

Types ¶

type HelperT ¶

type HelperT interface {
	Helper()
}

HelperT is a subset of testing.T that implements the Helper function

type TestingT ¶

type TestingT interface {
	Name() string
	Cleanup(func())
	Log(...any)
	Failed() bool
}

TestingT is an interface wrapper around *testing.T and *testing.B.

Source Files ¶

doc.go helper.go helpers.go stringutils.go temp_files.go

Directories ¶