testhelpers

Documentation

Index

• func AssertContains(t *testing.T, actual, expected string)
• func AssertContainsMatch(t *testing.T, actual, exp string)
• func AssertDirContainsFileWithContents(t *testing.T, dir string, file string, expected string)
• func AssertEq(t *testing.T, actual, expected interface{})
• func AssertError(t *testing.T, actual error, expected string)
• func AssertMatch(t *testing.T, actual string, expected string)
• func AssertNil(t *testing.T, actual interface{})
• func AssertNotContains(t *testing.T, actual, expected string)
• func AssertNotEq(t *testing.T, actual, expected interface{})
• func AssertNotNil(t *testing.T, actual interface{})
• func AssertOnTarEntry(t *testing.T, tarFile, entryPath string, assertFns ...TarEntryAssertion)
• func AssertSameInstance(t *testing.T, actual, expected interface{})
• func AssertSliceContains(t *testing.T, slice []string, value string)
• func CreateImageOnLocal(t *testing.T, dockerCli *client.Client, repoName, dockerFile string)
• func CreateImageOnRemote(t *testing.T, dockerCli *client.Client, registryConfig *TestRegistryConfig, ...) string
• func DockerRmi(dockerCli *client.Client, repoNames ...string) error
• func Eventually(t *testing.T, test func() bool, every time.Duration, timeout time.Duration)
• func HttpGetE(url string, headers map[string]string) (string, error)
• func ImageID(t *testing.T, repoName string) string
• func NewFakeBuilderImage(t *testing.T, name string, buildpacks []builder.BuildpackMetadata, ...) *fakes.Image
• func PullImageWithAuth(dockerCli *client.Client, ref, registryAuth string) error
• func PushImage(dockerCli *client.Client, ref string, registryConfig *TestRegistryConfig) error
• func RandString(n int) string
• func RecursiveCopy(t *testing.T, src, dst string)
• func RequireDocker(t *testing.T)
• func Run(t *testing.T, cmd *exec.Cmd) string
• func RunContainer(ctx context.Context, dockerCli *client.Client, id string, stdout io.Writer, ...) error
• func RunE(cmd *exec.Cmd) (string, error)
• func UntarSingleFile(r io.Reader, fileName string) ([]byte, error)
• type FakeImageFetcher
  • func NewFakeImageFetcher() *FakeImageFetcher
  • func (f *FakeImageFetcher) Fetch(ctx context.Context, name string, daemon, pull bool) (imgutil.Image, error)
• type FakeLifecycle
  • func (f *FakeLifecycle) Execute(ctx context.Context, opts build.LifecycleOptions) error
• type FetchArgs
• type TarEntryAssertion
  • func ContentEquals(expected string) TarEntryAssertion
  • func HasFileMode(expectedMode int64) TarEntryAssertion
  • func HasOwnerAndGroup(expectedUID int, expectedGID int) TarEntryAssertion
  • func SymlinksTo(expectedTarget string) TarEntryAssertion
• type TestRegistryConfig
  • func RunRegistry(t *testing.T, seedRegistry bool) *TestRegistryConfig
  • func (r *TestRegistryConfig) AuthConfig() dockertypes.AuthConfig
  • func (r *TestRegistryConfig) Login(t *testing.T, username string, password string)
  • func (rc *TestRegistryConfig) RegistryAuth() string
  • func (rc *TestRegistryConfig) RegistryCatalog() (string, error)
  • func (rc *TestRegistryConfig) RepoName(name string) string
  • func (rc *TestRegistryConfig) StopRegistry(t *testing.T)

Functions

func AssertContains

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

func AssertContainsMatch

func AssertContainsMatch(t *testing.T, actual, exp string)

func AssertDirContainsFileWithContents

func AssertDirContainsFileWithContents(t *testing.T, dir string, file string, expected 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 AssertMatch

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

func AssertNil

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

func AssertNotContains

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

func AssertNotEq

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

func AssertNotNil

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

func AssertOnTarEntry

func AssertOnTarEntry(t *testing.T, tarFile, entryPath string, assertFns ...TarEntryAssertion)

func AssertSameInstance

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

Assert the simplistic pointer (or literal value) equality

func AssertSliceContains

func AssertSliceContains(t *testing.T, slice []string, value string)

func CreateImageOnLocal

func CreateImageOnLocal(t *testing.T, dockerCli *client.Client, repoName, dockerFile string)

func CreateImageOnRemote

func CreateImageOnRemote(t *testing.T, dockerCli *client.Client, registryConfig *TestRegistryConfig, repoName, dockerFile string) string

func DockerRmi

func DockerRmi(dockerCli *client.Client, repoNames ...string) error

func Eventually

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

func HttpGetE

func HttpGetE(url string, headers map[string]string) (string, error)

func ImageID

func ImageID(t *testing.T, repoName string) string

func NewFakeBuilderImage

func NewFakeBuilderImage(t *testing.T, name string, buildpacks []builder.BuildpackMetadata, config builder.Config) *fakes.Image

func PullImageWithAuth

func PullImageWithAuth(dockerCli *client.Client, ref, registryAuth string) error

func PushImage

func PushImage(dockerCli *client.Client, ref string, registryConfig *TestRegistryConfig) error

func RandString

func RandString(n int) string

func RecursiveCopy

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

func RequireDocker

func RequireDocker(t *testing.T)

func Run

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

func RunContainer

func RunContainer(ctx context.Context, dockerCli *client.Client, id string, stdout io.Writer, stderr io.Writer) error

func RunE

func RunE(cmd *exec.Cmd) (string, error)

func UntarSingleFile

func UntarSingleFile(r io.Reader, fileName string) ([]byte, error)

Types

type FakeImageFetcher

type FakeImageFetcher struct {
	LocalImages  map[string]imgutil.Image
	RemoteImages map[string]imgutil.Image
	FetchCalls   map[string]*FetchArgs
}

func NewFakeImageFetcher

func NewFakeImageFetcher() *FakeImageFetcher

func (*FakeImageFetcher) Fetch

func (f *FakeImageFetcher) Fetch(ctx context.Context, name string, daemon, pull bool) (imgutil.Image, error)

type FakeLifecycle

type FakeLifecycle struct {
	Opts build.LifecycleOptions
}

func (*FakeLifecycle) Execute

func (f *FakeLifecycle) Execute(ctx context.Context, opts build.LifecycleOptions) error

type FetchArgs

type FetchArgs struct {
	Daemon bool
	Pull   bool
}

type TarEntryAssertion

type TarEntryAssertion func(*testing.T, *tar.Header, []byte)

func ContentEquals

func ContentEquals(expected string) TarEntryAssertion

func HasFileMode

func HasFileMode(expectedMode int64) TarEntryAssertion

func HasOwnerAndGroup

func HasOwnerAndGroup(expectedUID int, expectedGID int) TarEntryAssertion

func SymlinksTo

func SymlinksTo(expectedTarget string) TarEntryAssertion

type TestRegistryConfig

type TestRegistryConfig struct {
	RunRegistryPort string
	DockerConfigDir string
	// contains filtered or unexported fields
}

func RunRegistry

func RunRegistry(t *testing.T, seedRegistry bool) *TestRegistryConfig

func (*TestRegistryConfig) AuthConfig

func (r *TestRegistryConfig) AuthConfig() dockertypes.AuthConfig

func (*TestRegistryConfig) Login

func (r *TestRegistryConfig) Login(t *testing.T, username string, password string)

func (*TestRegistryConfig) RegistryAuth

func (rc *TestRegistryConfig) RegistryAuth() string

func (*TestRegistryConfig) RegistryCatalog

func (rc *TestRegistryConfig) RegistryCatalog() (string, error)

func (*TestRegistryConfig) RepoName

func (rc *TestRegistryConfig) RepoName(name string) string

func (*TestRegistryConfig) StopRegistry

func (rc *TestRegistryConfig) StopRegistry(t *testing.T)