testutils

Documentation

Index

• func FindFreePort(t *testing.T, host string, maxAttempts int) (int, error)
• type Expectation
• type LogHarness
  • func (h *LogHarness) Expect(s string)
  • func (h *LogHarness) ExpectPrefix(s string)
  • func (h *LogHarness) NewSequence(name string) *Sequence
  • func (h *LogHarness) Run(t *testing.T, f func())
• type Sequence
  • func (seq *Sequence) Assert(t *testing.T, s *bufio.Scanner)
  • func (seq *Sequence) Expect(s string)
  • func (seq *Sequence) ExpectPrefix(s string)

Functions

func FindFreePort

func FindFreePort(t *testing.T, host string, maxAttempts int) (int, error)

FindFreePort attempts to find an unused tcp port

Types

type Expectation

type Expectation interface {
	IsMatch(line string) bool
	String() string
}

type LogHarness

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

A LogHarness runs sets of assertions against the log output of a function. Assertions are grouped into sequences of messages that are expected to be found in the log output. Calling one of the Expect methods on the harness adds an expectation to the default sequence of messages. Additional sequences can be created by calling NewSequence.

func (*LogHarness) Expect

func (h *LogHarness) Expect(s string)

Expect adds an expectation to the default sequence that the log contains a line equal to s

func (*LogHarness) ExpectPrefix

func (h *LogHarness) ExpectPrefix(s string)

ExpectPrefix adds an to the default sequence expectation that the log contains a line starting with s

func (*LogHarness) NewSequence

func (h *LogHarness) NewSequence(name string) *Sequence

NewSequence creates a new sequence of expected log messages

func (*LogHarness) Run

func (h *LogHarness) Run(t *testing.T, f func())

Run executes the function f and captures any output written using Go's standard log. Each sequence of expected messages is then

type Sequence

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

func (*Sequence) Assert

func (seq *Sequence) Assert(t *testing.T, s *bufio.Scanner)

func (*Sequence) Expect

func (seq *Sequence) Expect(s string)

Expect adds an expectation that the log contains a line equal to s

func (*Sequence) ExpectPrefix

func (seq *Sequence) ExpectPrefix(s string)

ExpectPrefix adds an expectation that the log contains a line starting with s