testhelpers

Documentation

Index

• func AllLogs(logHandler *memory.Handler) string
• func AssertContains(t *testing.T, slice []string, elements ...string)
• func AssertEq(t *testing.T, actual, expected interface{})
• func AssertError(t *testing.T, actual error, expected string)
• func AssertJSONEq(t *testing.T, expected, actual string)
• func AssertLogEntry(t *testing.T, logHandler *memory.Handler, expected string)
• func AssertMatch(t *testing.T, actual string, expected string)
• func AssertNil(t *testing.T, actual interface{})
• func AssertNoLogEntry(t *testing.T, logHandler *memory.Handler, expected string)
• func AssertNotNil(t *testing.T, actual interface{})
• func AssertPathDoesNotExist(t *testing.T, path string)
• func AssertPathExists(t *testing.T, path string)
• func AssertSameInstance(t *testing.T, actual, expected interface{})
• func AssertStringContains(t *testing.T, str string, expected string)
• func AssertStringDoesNotContain(t *testing.T, str string, expected string)
• func CleanEndings(s string) string
• func ComputeSHA256ForFile(t *testing.T, path string) string
• func CopyFile(t *testing.T, srcFileName, destFileName string)
• func CreateSingleFileTar(path, txt string) (io.Reader, error)
• func DockerBuild(t *testing.T, name, context string, ops ...DockerCmdOp)
• func DockerCli(t *testing.T) dockercli.CommonAPIClient
• func DockerContainerExists(t *testing.T, containerName string) bool
• func DockerCopyOut(t *testing.T, containerName, srcCtrPath, outputDir string) string
• func DockerImageRemove(t *testing.T, name string)
• func DockerRun(t *testing.T, image string, ops ...DockerCmdOp) string
• func DockerRunAndCopy(t *testing.T, containerName, outputDir, outputCtrPath, image string, ...) string
• func DockerSeedRunAndCopy(t *testing.T, ...) string
• func DockerVolumeExists(t *testing.T, volumeName string) bool
• func DockerVolumeRemove(t *testing.T, volume string)
• func Eventually(t *testing.T, test func() bool, every time.Duration, timeout time.Duration)
• func GetUmask(t *testing.T) int
• func HTTPGetE(url string) (string, error)
• func MakeAndCopyLifecycle(t *testing.T, goos, goarch, destDir string, envs ...string)
• func Mkdir(t *testing.T, dirs ...string)
• func Mkfile(t *testing.T, data string, paths ...string)
• func MustReadFile(t *testing.T, path string) []byte
• func PushImage(dockerCli dockercli.CommonAPIClient, ref string, auth string) error
• func RandString(n int) string
• func RandomLayer(t *testing.T, tmpDir string) (path string, sha string, contents []byte)
• func Rdfile(t *testing.T, path string) string
• func RecursiveCopy(t *testing.T, src, dst string)
• func Run(t *testing.T, cmd *exec.Cmd) string
• func RunE(cmd *exec.Cmd) (output string, exitCode int, err error)
• func SeedDockerVolume(t *testing.T, srcPath string) string
• func SkipIf(t *testing.T, expression bool, reason string)
• type DockerCmd
• type DockerCmdOp
  • func WithArgs(args ...string) DockerCmdOp
  • func WithBash(args ...string) DockerCmdOp
  • func WithFlags(flags ...string) DockerCmdOp

Functions

func AllLogs

func AllLogs(logHandler *memory.Handler) string

func AssertContains

func AssertContains(t *testing.T, slice []string, elements ...string)

func AssertEq

func AssertEq(t *testing.T, actual, expected interface{})

Assert deep equality (and provide useful difference as a test failure)

func AssertError

func AssertError(t *testing.T, actual error, expected string)

func AssertJSONEq

func AssertJSONEq(t *testing.T, expected, actual string)

func AssertLogEntry

func AssertLogEntry(t *testing.T, logHandler *memory.Handler, expected string)

func AssertMatch

func AssertMatch(t *testing.T, actual string, expected string)

func AssertNil

func AssertNil(t *testing.T, actual interface{})

func AssertNoLogEntry

func AssertNoLogEntry(t *testing.T, logHandler *memory.Handler, expected string)

func AssertNotNil

func AssertNotNil(t *testing.T, actual interface{})

func AssertPathDoesNotExist

func AssertPathDoesNotExist(t *testing.T, path string)

func AssertPathExists

func AssertPathExists(t *testing.T, path string)

func AssertSameInstance

func AssertSameInstance(t *testing.T, actual, expected interface{})

Assert the simplistic pointer (or literal value) equality

func AssertStringContains

func AssertStringContains(t *testing.T, str string, expected string)

func AssertStringDoesNotContain

func AssertStringDoesNotContain(t *testing.T, str string, expected string)

func CleanEndings

func CleanEndings(s string) string

func ComputeSHA256ForFile

func ComputeSHA256ForFile(t *testing.T, path string) string

func CopyFile

func CopyFile(t *testing.T, srcFileName, destFileName string)

func CreateSingleFileTar

func CreateSingleFileTar(path, txt string) (io.Reader, error)

func DockerBuild

func DockerBuild(t *testing.T, name, context string, ops ...DockerCmdOp)

func DockerCli

func DockerCli(t *testing.T) dockercli.CommonAPIClient

func DockerContainerExists

func DockerContainerExists(t *testing.T, containerName string) bool

func DockerCopyOut

func DockerCopyOut(t *testing.T, containerName, srcCtrPath, outputDir string) string

func DockerImageRemove

func DockerImageRemove(t *testing.T, name string)

func DockerRun

func DockerRun(t *testing.T, image string, ops ...DockerCmdOp) string

func DockerRunAndCopy

func DockerRunAndCopy(t *testing.T, containerName, outputDir, outputCtrPath, image string, ops ...DockerCmdOp) string

DockerRunAndCopy runs a container and once stopped, outputCtrPath is copied to outputDir

func DockerSeedRunAndCopy

func DockerSeedRunAndCopy(t *testing.T, containerName, srcDir, srcCtrPath, outputDir, outputCtrPath, image string, ops ...DockerCmdOp) string

DockerSeedRunAndCopy copies srcDir to container's srcCtrPath before container is started. Once stopped, outputCtrPath is copied to outputDir On WCOW, only works when seeding to container directory (not a mounted volume)

func DockerVolumeExists

func DockerVolumeExists(t *testing.T, volumeName string) bool

func DockerVolumeRemove

func DockerVolumeRemove(t *testing.T, volume string)

func Eventually

func Eventually(t *testing.T, test func() bool, every time.Duration, timeout time.Duration)

func GetUmask

func GetUmask(t *testing.T) int

func HTTPGetE

func HTTPGetE(url string) (string, error)

func MakeAndCopyLifecycle

func MakeAndCopyLifecycle(t *testing.T, goos, goarch, destDir string, envs ...string)

func Mkdir

func Mkdir(t *testing.T, dirs ...string)

func Mkfile

func Mkfile(t *testing.T, data string, paths ...string)

func MustReadFile

func MustReadFile(t *testing.T, path string) []byte

func PushImage

func PushImage(dockerCli dockercli.CommonAPIClient, ref string, auth string) error

TODO: re-work this function to exec the docker cli, or convert other docker helpers to using the client library.

func RandString

func RandString(n int) string

func RandomLayer

func RandomLayer(t *testing.T, tmpDir string) (path string, sha string, contents []byte)

func Rdfile

func Rdfile(t *testing.T, path string) string

func RecursiveCopy

func RecursiveCopy(t *testing.T, src, dst string)

func Run

func Run(t *testing.T, cmd *exec.Cmd) string

func RunE

func RunE(cmd *exec.Cmd) (output string, exitCode int, err error)

func SeedDockerVolume

func SeedDockerVolume(t *testing.T, srcPath string) string

SeedDockerVolume only works with Linux daemons as Windows only mounts volumes for started containers

func SkipIf

func SkipIf(t *testing.T, expression bool, reason string)

Types

type DockerCmd

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

type DockerCmdOp

type DockerCmdOp func(*DockerCmd)

func WithArgs

func WithArgs(args ...string) DockerCmdOp

func WithBash

func WithBash(args ...string) DockerCmdOp

func WithFlags

func WithFlags(flags ...string) DockerCmdOp