log

Documentation

Overview

Package log contains logging related functionality

Package log contains logging related functionality

Index

• func IsTerminal(w io.Writer) bool
• func LevelsString() string
• type Status
  • func NewStatus(w io.Writer) *Status
  • func (s *Status) End(success bool)
  • func (s *Status) MaybeWrapLogrus(logger *logrus.Logger)
  • func (s *Status) MaybeWrapWriter(w io.Writer) io.Writer
  • func (s *Status) Start(status string)
  • func (s *Status) WrapLogrus(logger *logrus.Logger)
  • func (s *Status) WrapWriter(w io.Writer) io.Writer
• type StatusFriendlyWriter
  • func (ww *StatusFriendlyWriter) Write(p []byte) (n int, err error)

Functions

func IsTerminal

func IsTerminal(w io.Writer) bool

IsTerminal returns true if the writer w is a terminal

func LevelsString

func LevelsString() string

LevelsString returns a string representing all log levels this is useful for help text / flag info

Types

type Status

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

Status is used to track ongoing status in a CLI, with a nice loading spinner when attached to a terminal

func NewStatus

func NewStatus(w io.Writer) *Status

NewStatus creates a new default Status

func (*Status) End

func (s *Status) End(success bool)

End completes the current status, ending any previous spinning and marking the status as success or failure

func (*Status) MaybeWrapLogrus

func (s *Status) MaybeWrapLogrus(logger *logrus.Logger)

MaybeWrapLogrus behaves like MaybeWrapWriter for a logrus logger

func (*Status) MaybeWrapWriter

func (s *Status) MaybeWrapWriter(w io.Writer) io.Writer

MaybeWrapWriter returns a StatusFriendlyWriter for w IFF w and spinner's output are a terminal, otherwise it returns w

func (*Status) Start

func (s *Status) Start(status string)

Start starts a new phase of the status, if attached to a terminal there will be a loading spinner with this status

func (*Status) WrapLogrus

func (s *Status) WrapLogrus(logger *logrus.Logger)

WrapLogrus wraps a logrus logger's output with a StatusFriendlyWriter

func (*Status) WrapWriter

func (s *Status) WrapWriter(w io.Writer) io.Writer

WrapWriter returns a StatusFriendlyWriter for w

type StatusFriendlyWriter

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

StatusFriendlyWriter is used to wrap another Writer to make it toggle the status spinner before and after writes so that they do not collide

func (*StatusFriendlyWriter) Write

func (ww *StatusFriendlyWriter) Write(p []byte) (n int, err error)