testutil

Documentation

Overview

Package testutil provides various helper functions for tests

Index

• func AssertTrueBeforeTimeout(t *testing.T, frequency, timeout time.Duration, condition func() bool)
• func Detab(str string) string
• func Fuzz(t *testing.T, test func(int64))
• func RequireTrueBeforeTimeout(t *testing.T, frequency, timeout time.Duration, condition func() bool)
• type TempFolder
  • func NewTempFolder(namePrefix string) (*TempFolder, error)
  • func (f *TempFolder) Add(fileName string, contents string) error
  • func (f *TempFolder) Delete(fileName string) error
  • func (f *TempFolder) RemoveAll() error

Functions

func AssertTrueBeforeTimeout

func AssertTrueBeforeTimeout(t *testing.T, frequency, timeout time.Duration, condition func() bool)

AssertTrueBeforeTimeout regularly checks whether a condition is met. It does so until a timeout is reached, in which case it makes the test fail. Condition is evaluated in a goroutine to avoid tests hanging if a system is deadlocked.

func Detab

func Detab(str string) string

Detab removes whitespace from the front of a string on every line

func Fuzz

func Fuzz(t *testing.T, test func(int64))

Fuzz implements poor-soul's attempt at fuzzing. The idea is to catch edge cases by running a bunch of random, but deterministic (the same on every run), scenarios. In "-short" mode it runs for about 100ms; otherwise about 1s.

The `test` function should use its input as a seed to a random number generator.

func RequireTrueBeforeTimeout

func RequireTrueBeforeTimeout(t *testing.T, frequency, timeout time.Duration, condition func() bool)

RequireTrueBeforeTimeout is the same as AssertTrueBeforeTimeout, but it calls t.failNow() if the condition function times out.

Types

type TempFolder

type TempFolder struct {
	RootPath string
}

TempFolder is a temporary folder used for testing

func NewTempFolder

func NewTempFolder(namePrefix string) (*TempFolder, error)

NewTempFolder creates a new temporary folder

func (*TempFolder) Add

func (f *TempFolder) Add(fileName string, contents string) error

Add adds a file to a temp folder

func (*TempFolder) Delete

func (f *TempFolder) Delete(fileName string) error

Delete removes a specific file

func (*TempFolder) RemoveAll

func (f *TempFolder) RemoveAll() error

RemoveAll purges a TempFolder