testutil

Documentation

Overview

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.