testutils

Documentation

Overview

Package testutils provides various utilities for use in tests.

Index

• func ArtifactGoogleCreds(tb testing.TB) string
• func BackingMongoDBClient(tb testing.TB) *mongo.Client
• func BackingMongoDBURI(tb testing.TB) string
• func GenerateSelfSignedCertificate(commonName string, altNames ...string) (tls.Certificate, string, string, *x509.CertPool, error)
• func NewMongoDBNamespace() (string, string)
• func ReserveRandomListener(tb testing.TB) *net.TCPListener
• func SkipUnlessArtifactGoogleCreds(tb testing.TB)
• func SkipUnlessBackingMongoDBURI(tb testing.TB)
• func SkipUnlessInternet(tb testing.TB)
• func Teardown()
• func TempDir(dir, pattern string) (string, error)
• func TempDirT(tb testing.TB, dir, pattern string) string
• func TempFile(tb testing.TB, name string) *os.File
• func TestMain(t *testing.T, ...)
• func WaitForAssertion(t *testing.T, assertion func(tb testing.TB))
• func WaitForAssertionWithSleep(t *testing.T, wait time.Duration, maxAttempts int, ...)
• func WaitSuccessfulDial(address string) error
• type ContextualMainExecution
  • func ContextualMain(main func(ctx context.Context, args []string, logger golog.Logger) error, ...) ContextualMainExecution
• type MainTestCase

Functions

func ArtifactGoogleCreds

func ArtifactGoogleCreds(tb testing.TB) string

ArtifactGoogleCreds returns the google credentials for artifact.

func BackingMongoDBClient

func BackingMongoDBClient(tb testing.TB) *mongo.Client

BackingMongoDBClient returns a backing MongoDB client to use.

func BackingMongoDBURI

func BackingMongoDBURI(tb testing.TB) string

BackingMongoDBURI returns the backing MongoDB URI to use.

func GenerateSelfSignedCertificate

func GenerateSelfSignedCertificate(commonName string, altNames ...string) (tls.Certificate, string, string, *x509.CertPool, error)

GenerateSelfSignedCertificate generates a self signed certificate with the given names.

func NewMongoDBNamespace

func NewMongoDBNamespace() (string, string)

NewMongoDBNamespace returns a new random namespace to use.

func ReserveRandomListener

func ReserveRandomListener(tb testing.TB) *net.TCPListener

ReserveRandomListener returns a new TCP listener at a random port.

func SkipUnlessArtifactGoogleCreds

func SkipUnlessArtifactGoogleCreds(tb testing.TB)

SkipUnlessArtifactGoogleCreds verifies google credentials are available for artifact.

func SkipUnlessBackingMongoDBURI

func SkipUnlessBackingMongoDBURI(tb testing.TB)

SkipUnlessBackingMongoDBURI verifies there is a backing MongoDB URI to use.

func SkipUnlessInternet

func SkipUnlessInternet(tb testing.TB)

SkipUnlessInternet verifies there is an internet connection.

func Teardown

func Teardown()

Teardown cleans up any temporary resources used by tests.

func TempDir

func TempDir(dir, pattern string) (string, error)

TempDir creates a temporary directory and fails the test if it cannot.

func TempDirT

func TempDirT(tb testing.TB, dir, pattern string) string

TempDirT creates a temporary directory and fails the test if it cannot.

func TempFile

func TempFile(tb testing.TB, name string) *os.File

TempFile returns a new unique temporary file using the given name.

func TestMain

func TestMain(t *testing.T, mainWithArgs func(ctx context.Context, args []string, logger golog.Logger) error, tcs []MainTestCase)

TestMain tests a main function with a series of test cases in serial.

func WaitForAssertion

func WaitForAssertion(t *testing.T, assertion func(tb testing.TB))

WaitForAssertion waits for a testify.Assertion to succeed or ultimately fail. Note: This should only be used if there's absolutely no way to have the test code be able to be signaled that the assertion is ready to be checked. That is, if waiting with respect time is critical, it's okay to use this.

func WaitForAssertionWithSleep

func WaitForAssertionWithSleep(t *testing.T, wait time.Duration, maxAttempts int, assertion func(tb testing.TB))

WaitForAssertionWithSleep is similar to WaitForAssertion but takes a wait time and maximum number of attempts as parameters.

func WaitSuccessfulDial

func WaitSuccessfulDial(address string) error

WaitSuccessfulDial waits for a dial attempt to succeed.

Types

type ContextualMainExecution

type ContextualMainExecution struct {
	Ready       <-chan struct{}
	Done        <-chan error
	Start       func()
	Stop        func()
	QuitSignal  func(t *testing.T)             // reflects syscall.SIGQUIT
	ExpectIters func(t *testing.T, amount int) // expect a certain amount of iters
	WaitIters   func(t *testing.T)             // waits for iters defined by ExpectIters
}

ContextualMainExecution reflects the execution of a main function that can have its lifecycle partially controlled.

func ContextualMain

func ContextualMain(
	main func(ctx context.Context, args []string, logger golog.Logger) error,
	args []string,
	logger golog.Logger,
) ContextualMainExecution

ContextualMain calls a main entry point function with a cancellable context via the returned execution struct. The main function is run in a separate goroutine.

type MainTestCase

type MainTestCase struct {
	Name   string
	Args   []string
	Err    string
	Before func(t *testing.T, logger golog.Logger, exec *ContextualMainExecution)
	During func(ctx context.Context, t *testing.T, exec *ContextualMainExecution)
	After  func(t *testing.T, logs *observer.ObservedLogs)
}

MainTestCase describes how to execute a main function and what to expect from it.