logging

Documentation

Overview

Package logging defines the minimal interface that loggers must support to be used by pack.

Index

• func GetWriterForLevel(logger Logger, level Level) io.Writer
• func IsQuiet(logger Logger) bool
• func Tip(l Logger, format string, v ...interface{})
• type Level
• type Logger
  • func New(w io.Writer) Logger
• type PrefixWriter
  • func NewPrefixWriter(w io.Writer, prefix string) *PrefixWriter
  • func (w *PrefixWriter) Write(buf []byte) (int, error)
• type WithSelectableWriter

Functions

func GetWriterForLevel

func GetWriterForLevel(logger Logger, level Level) io.Writer

GetWriterForLevel retrieves the appropriate Writer for the log level provided.

See WithSelectableWriter

func IsQuiet

func IsQuiet(logger Logger) bool

IsQuiet defines whether a pack logger is set to quiet mode

func Tip

func Tip(l Logger, format string, v ...interface{})

Tip logs a tip.

Types

type Level

type Level int

const (
	DebugLevel Level = iota
	InfoLevel
	WarnLevel
	ErrorLevel
)

type Logger

type Logger interface {
	Debug(msg string)
	Debugf(fmt string, v ...interface{})

	Info(msg string)
	Infof(fmt string, v ...interface{})

	Warn(msg string)
	Warnf(fmt string, v ...interface{})

	Error(msg string)
	Errorf(fmt string, v ...interface{})

	Writer() io.Writer

	IsVerbose() bool
}

Logger defines behavior required by a logging package used by pack libraries

func New

func New(w io.Writer) Logger

New creates a default logger for the pack library. Note that the pack CLI has it's own logger.

type PrefixWriter

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

PrefixWriter will prefix writes

func NewPrefixWriter

func NewPrefixWriter(w io.Writer, prefix string) *PrefixWriter

NewPrefixWriter writes by w will be prefixed

func (*PrefixWriter) Write

func (w *PrefixWriter) Write(buf []byte) (int, error)

Writes bytes to the embedded log function

type WithSelectableWriter

type WithSelectableWriter interface {
	WriterForLevel(level Level) io.Writer
}

WithSelectableWriter is an optional interface for loggers that want to support a separate writer per log level.