runner

Documentation

Overview

Package runner allows you to run a binary in an acceptance test (scan output for ports, wait for start).

It is part of our belief that testing binaries that will be shipping into production with as little modification as is possible is one of the most effective ways of producing high value tests.

Index

• type Result
  • func (r *Result) APIAddr() string
  • func (r *Result) AdminAddr() string
  • func (r *Result) Logs() string
  • func (r *Result) Stop() error
  • func (r *Result) Wait() chan error
• type Runner
  • func New(baseEnv ...string) *Runner
  • func NewWithDynamicEnv(baseEnv []string, dynamicEnv func() []string) *Runner
  • func (r *Runner) Run(serverName, binary string, extraEnv ...string) (*Result, error)
  • func (r *Runner) Start(binary string, extraEnv ...string) (*Result, error)
  • func (r *Runner) Stop() error

Types

type Result

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

func (*Result) APIAddr

func (r *Result) APIAddr() string

func (*Result) AdminAddr

func (r *Result) AdminAddr() string

func (*Result) Logs

func (r *Result) Logs() string

func (*Result) Stop

func (r *Result) Stop() error

Stop the process, returning the exit error.

func (*Result) Wait

func (r *Result) Wait() chan error

Wait for the process to exit in a goroutine. The exit error is returned on the channel when the process exits.

type Runner

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

func New

func New(baseEnv ...string) *Runner

func NewWithDynamicEnv

func NewWithDynamicEnv(baseEnv []string, dynamicEnv func() []string) *Runner

func (*Runner) Run

func (r *Runner) Run(serverName, binary string, extraEnv ...string) (*Result, error)

Run starts the output service and waits a few seconds to confirm it has started successfully. The caller is responsible for calling Runner.Stop.

func (*Runner) Start

func (r *Runner) Start(binary string, extraEnv ...string) (*Result, error)

Start the `output` service, returning a buffer which contains the logs (stderr) of the process. The caller is responsible for calling Result.Stop and Runner.Stop.

func (*Runner) Stop

func (r *Runner) Stop() error