tstest

Documentation

Overview

Package tstest provides utilities for use in unit tests.

Index

• func FixLogs(t *testing.T)
• func PanicOnLog()
• func ResourceCheck(tb testing.TB)
• func UnfixLogs(t *testing.T)
• func WaitFor(maxWait time.Duration, try func() error) error
• type Clock
  • func (c *Clock) Advance(d time.Duration)
  • func (c *Clock) Now() time.Time
  • func (c *Clock) Reset()
• type LogLineTracker
  • func NewLogLineTracker(logf logger.Logf, expectedFormatStrings []string) *LogLineTracker
  • func (lt *LogLineTracker) Check() []string
  • func (lt *LogLineTracker) Close()
  • func (lt *LogLineTracker) Logf(format string, args ...interface{})
  • func (lt *LogLineTracker) Reset()

Functions

func FixLogs

func FixLogs(t *testing.T)

func PanicOnLog

func PanicOnLog()

PanicOnLog modifies the standard library log package's default output to an io.Writer that panics, to root out code that's not plumbing their logging through explicit tailscale.com/logger.Logf paths.

func ResourceCheck

func ResourceCheck(tb testing.TB)

func UnfixLogs

func UnfixLogs(t *testing.T)

func WaitFor

func WaitFor(maxWait time.Duration, try func() error) error

WaitFor retries try for up to maxWait. It returns nil once try returns nil the first time. If maxWait passes without success, it returns try's last error.

Types

type Clock

type Clock struct {
	// Start is the first value returned by Now.
	Start time.Time
	// Step is how much to advance with each Now call.
	Step time.Duration
	// Present is the time that the next Now call will receive.
	Present time.Time

	sync.Mutex
}

Clock is a testing clock that advances every time its Now method is called, beginning at Start.

The zero value starts virtual time at an arbitrary value recorded in Start on the first call to Now, and time never advances.

func (*Clock) Advance

func (c *Clock) Advance(d time.Duration)

func (*Clock) Now

func (c *Clock) Now() time.Time

Now returns the virtual clock's current time, and avances it according to its step configuration.

func (*Clock) Reset

func (c *Clock) Reset()

Reset rewinds the virtual clock to its start time.

type LogLineTracker

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

LogLineTracker is a logger that tracks which log format patterns it's seen and can report which expected ones were not seen later.

func NewLogLineTracker

func NewLogLineTracker(logf logger.Logf, expectedFormatStrings []string) *LogLineTracker

NewLogLineTracker produces a LogLineTracker wrapping a given logf that tracks whether expectedFormatStrings were seen.

func (*LogLineTracker) Check

func (lt *LogLineTracker) Check() []string

Check returns which format strings haven't been logged yet.

func (*LogLineTracker) Close

func (lt *LogLineTracker) Close()

Close closes lt. After calling Close, calls to Logf become no-ops.

func (*LogLineTracker) Logf

func (lt *LogLineTracker) Logf(format string, args ...interface{})

Logf logs to its underlying logger and also tracks that the given format pattern has been seen.

func (*LogLineTracker) Reset

func (lt *LogLineTracker) Reset()

Reset forgets everything that it's seen.