testutil

Documentation

Overview

Package testutil contains test utilities.

Index

• func GetContainerMappedPortAddress(t *testing.T, containerID, privatePort string) string
• func GetInterestingTempDirectoryName() (string, error)
• func MustParseJSONLines(t *testing.T, lines []string, v interface{})
• func MyTestMain(m *testing.M)
• func ProviderTest(t *testing.T)
• func RunAllTestsWithParam(t *testing.T, v interface{})
• func RunContainerAndKillOnCloseOrSkip(t *testing.T, args ...string) string
• func RunDockerAndGetOutputOrSkip(tb testing.TB, args ...string) string
• func ShouldReduceTestComplexity() bool
• func ShouldSkipLongFilenames() bool
• func ShouldSkipUnicodeFilenames() bool
• func TempDirectory(tb testing.TB) string
• func TempLogDirectory(t *testing.T) string
• func TestSkipOnCIUnlessLinuxAMD64(tb testing.TB)
• func TestSkipUnlessCI(tb testing.TB, msg string, args ...interface{})

Functions

func GetContainerMappedPortAddress

func GetContainerMappedPortAddress(t *testing.T, containerID, privatePort string) string

GetContainerMappedPortAddress returns <host>:<port> that can be used to connect to a given container and private port.

func GetInterestingTempDirectoryName

func GetInterestingTempDirectoryName() (string, error)

GetInterestingTempDirectoryName returns interesting directory name used for testing.

func MustParseJSONLines

func MustParseJSONLines(t *testing.T, lines []string, v interface{})

MustParseJSONLines parses the lines containing JSON into the provided object.

func MyTestMain

func MyTestMain(m *testing.M)

MyTestMain runs tests and verifies some post-run invariants.

func ProviderTest

func ProviderTest(t *testing.T)

ProviderTest marks the test method so that it only runs in provider-tests suite.

func RunAllTestsWithParam

func RunAllTestsWithParam(t *testing.T, v interface{})

RunAllTestsWithParam uses reflection to run all test methods starting with 'Test' on the provided object. nolint:thelper

func RunContainerAndKillOnCloseOrSkip

func RunContainerAndKillOnCloseOrSkip(t *testing.T, args ...string) string

RunContainerAndKillOnCloseOrSkip runs "docker run" and ensures that resulting container is killed on exit. Returns containerID.

func RunDockerAndGetOutputOrSkip

func RunDockerAndGetOutputOrSkip(tb testing.TB, args ...string) string

RunDockerAndGetOutputOrSkip runs Docker and returns the output as a string.

func ShouldReduceTestComplexity

func ShouldReduceTestComplexity() bool

ShouldReduceTestComplexity returns true if test complexity should be reduced on the current machine.

func ShouldSkipLongFilenames

func ShouldSkipLongFilenames() bool

ShouldSkipLongFilenames returns true if: an environmental variable is unset, set to false, test is running on ARM, or if running race detection.

func ShouldSkipUnicodeFilenames

func ShouldSkipUnicodeFilenames() bool

ShouldSkipUnicodeFilenames returns true if: an environmental variable is unset, set to false, test is running on ARM, or if running race detection.

func TempDirectory

func TempDirectory(tb testing.TB) string

TempDirectory returns an interesting temporary directory and cleans it up before test completes.

func TempLogDirectory

func TempLogDirectory(t *testing.T) string

TempLogDirectory returns a temporary directory used for storing logs. If KOPIA_LOGS_DIR is provided.

func TestSkipOnCIUnlessLinuxAMD64

func TestSkipOnCIUnlessLinuxAMD64(tb testing.TB)

TestSkipOnCIUnlessLinuxAMD64 skips the current test if running on CI unless the environment is Linux/AMD64.

func TestSkipUnlessCI

func TestSkipUnlessCI(tb testing.TB, msg string, args ...interface{})

TestSkipUnlessCI skips the current test with a provided message, except when running in CI environment, in which case it causes hard failure.