Documentation ¶
Overview ¶
Package ioes or "in, out, error streams" provides standard names and utilities for working with traditional stdin/stdout/stderr streams.
Index ¶
- type IOStreams
- func (s IOStreams) Close() error
- func (s IOStreams) IsCygwinTerminal() bool
- func (s IOStreams) IsTerminal() bool
- func (s IOStreams) Print(msg string)
- func (s IOStreams) PrintErr(msg string)
- func (s IOStreams) SpinnerActive() bool
- func (s IOStreams) SpinnerMsg(msg string)
- func (s IOStreams) StartSpinner()
- func (s IOStreams) StopSpinner()
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type IOStreams ¶
type IOStreams struct { In io.Reader Out io.Writer ErrOut io.Writer // contains filtered or unexported fields }
IOStreams provides standard names for iostreams and common methods for managing progress indicators & other contextual output. IOStreams is broken out as a sepearate package to facilitate plumbing contextual feedback into the depths of an application architecture, while also providing clear state management for when contextual feedback doesn't work. As an example, IOStreams may be routed over websockets to provide HTTP output, and in this context it's far easier to disable things like spinners outright IOStreams must be created with a "New" method
func NewDiscardIOStreams ¶
func NewDiscardIOStreams() IOStreams
NewDiscardIOStreams returns a valid IOStreams that just discards
func NewIOStreams ¶
NewIOStreams creates streams
func NewStdIOStreams ¶
func NewStdIOStreams() IOStreams
NewStdIOStreams creates a standard set of streams, with in, out, and error mapped to os.Stdin, os.Stdout, and os.Stderr respectively
func NewTestIOStreams ¶
NewTestIOStreams returns a valid IOStreams and in, out, errout buffers for unit tests
func (IOStreams) Close ¶
Close checks to see if any/all of in/out/errOut are closable, and if so closes them
func (IOStreams) IsCygwinTerminal ¶ added in v0.1.1
IsCygwinTerminal returns true when IOStreams Out is a Cygwin file descriptor
func (IOStreams) IsTerminal ¶ added in v0.1.1
IsTerminal returns true when IOStreams Out is a terminal file descriptor
func (IOStreams) SpinnerActive ¶
SpinnerActive returns the active state of the progres spinner
func (IOStreams) SpinnerMsg ¶
SpinnerMsg sets the spinner suffix message
func (IOStreams) StartSpinner ¶
func (s IOStreams) StartSpinner()
StartSpinner begins the progress spinner
func (IOStreams) StopSpinner ¶
func (s IOStreams) StopSpinner()
StopSpinner halts the progress spinner