log

Documentation

Index

• Constants
• Variables
• func AllLevelsFilter(lvl Level) bool
• func CsvTextFormatter(r *Record) string
• func Debug(message string)
• func DebugLevelFilter(lvl Level) bool
• func Debugf(format string, args ...interface{})
• func Debugv(args ...interface{})
• func DefaultColorTextFormatterForHuman(r *Record) string
• func DefaultTextFormatter(r *Record) string
• func DefaultTextFormatterForHuman(r *Record) string
• func DisabledFilter(lvl Level) bool
• func Error(message string)
• func ErrorLevelFilter(lvl Level) bool
• func Errorf(format string, args ...interface{})
• func Errorv(args ...interface{})
• func Flush()
• func GetFilter(logger *Logger) func(Level) bool
• func GetFlags(logger *Logger) loggerFlags
• func HashColoredText(name string) string
• func Info(message string)
• func InfoLevelFilter(lvl Level) bool
• func Infof(format string, args ...interface{})
• func Infov(args ...interface{})
• func IsValidLevel(lvl Level) bool
• func Log(lvl Level, message string)
• func LogFilterForLevel(lvl Level) func(Level) bool
• func LogLevelColoredMsg(lvl Level, msg string) string
• func LogLevelString(lvl Level) string
• func Logf(lvl Level, format string, args ...interface{})
• func Logv(lvl Level, args ...interface{})
• func PaddedString(s string, width int) string
• func SetFilter(logger *Logger, filter func(Level) bool)
• func SetFlags(logger *Logger, flags loggerFlags)
• func SetLogger(l *Logger)
• func Trace(message string)
• func TraceLevelFilter(lvl Level) bool
• func Tracef(format string, args ...interface{})
• func Tracev(args ...interface{})
• func Warn(message string)
• func WarnLevelFilter(lvl Level) bool
• func Warnf(format string, args ...interface{})
• func Warnv(args ...interface{})
• type ColorStringer
• type Field
  • func GetFields(logger *Logger) []Field
• type Level
  • func LogLevelFromString(level string) Level
• type LeveledSink
  • func (l *LeveledSink) Flush()
  • func (l *LeveledSink) Log(r *Record)
• type LogWriter
  • func NewLogWriter(l *Logger, lvl Level, prefix string) *LogWriter
  • func (s *LogWriter) Write(p []byte) (n int, err error)
• type Logger
  • func GetLogger() *Logger
  • func New(sink Sink) *Logger
  • func With(name string, val interface{}) *Logger
  • func WithFields(fields []Field) *Logger
  • func (l *Logger) Debug(message string)
  • func (l *Logger) Debugf(format string, args ...interface{})
  • func (l *Logger) Debugv(args ...interface{})
  • func (l *Logger) Error(message string)
  • func (l *Logger) Errorf(format string, args ...interface{})
  • func (l *Logger) Errorv(args ...interface{})
  • func (l *Logger) Flush()
  • func (l *Logger) Info(message string)
  • func (l *Logger) Infof(format string, args ...interface{})
  • func (l *Logger) Infov(args ...interface{})
  • func (l *Logger) IsEnabled(lvl Level) bool
  • func (l *Logger) Log(lvl Level, message string)
  • func (l *Logger) Logf(lvl Level, format string, args ...interface{})
  • func (l *Logger) Logv(lvl Level, args ...interface{})
  • func (l *Logger) Trace(message string)
  • func (l *Logger) Tracef(format string, args ...interface{})
  • func (l *Logger) Tracev(args ...interface{})
  • func (l *Logger) Warn(message string)
  • func (l *Logger) Warnf(format string, args ...interface{})
  • func (l *Logger) Warnv(args ...interface{})
  • func (l *Logger) With(name string, value interface{}) *Logger
  • func (l *Logger) WithFields(fields []Field) *Logger
• type Metadata
• type MultiSink
  • func (m MultiSink) Flush()
  • func (m MultiSink) Log(r *Record)
• type NopSink
  • func (NopSink) Flush()
  • func (NopSink) Log(*Record)
• type Record
• type Sink
  • func CreateMultiSink(recs ...Sink) Sink
  • func GetSink(logger *Logger) Sink
• type StreamSink
  • func (s *StreamSink) Flush()
  • func (s *StreamSink) Log(r *Record)
• type SyncedSink
  • func (s *SyncedSink) Flush()
  • func (s *SyncedSink) Log(r *Record)

Constants

const (
	DisabledLevel Level = 0
	ErrorLevel          = 1 << (iota - 1)
	WarnLevel
	InfoLevel
	DebugLevel
	TraceLevel
)

Power of 2

const (
	FlagTime = 1 << (iota - 1)
	FlagSrcHint
)

Variables

var (
	NopLogger = newNopLogger()
)

Functions

func AllLevelsFilter

func AllLevelsFilter(lvl Level) bool

func CsvTextFormatter

func CsvTextFormatter(r *Record) string

func Debug

func Debug(message string)

func DebugLevelFilter

func DebugLevelFilter(lvl Level) bool

func Debugf

func Debugf(format string, args ...interface{})

func Debugv

func Debugv(args ...interface{})

func DefaultColorTextFormatterForHuman

func DefaultColorTextFormatterForHuman(r *Record) string

func DefaultTextFormatter

func DefaultTextFormatter(r *Record) string

func DefaultTextFormatterForHuman

func DefaultTextFormatterForHuman(r *Record) string

func DisabledFilter

func DisabledFilter(lvl Level) bool

func Error

func Error(message string)

func ErrorLevelFilter

func ErrorLevelFilter(lvl Level) bool

func Errorf

func Errorf(format string, args ...interface{})

func Errorv

func Errorv(args ...interface{})

func Flush

func Flush()

func GetFilter

func GetFilter(logger *Logger) func(Level) bool

func GetFlags

func GetFlags(logger *Logger) loggerFlags

func HashColoredText

func HashColoredText(name string) string

func Info

func Info(message string)

func InfoLevelFilter

func InfoLevelFilter(lvl Level) bool

func Infof

func Infof(format string, args ...interface{})

func Infov

func Infov(args ...interface{})

func IsValidLevel

func IsValidLevel(lvl Level) bool

func Log

func Log(lvl Level, message string)

func LogFilterForLevel

func LogFilterForLevel(lvl Level) func(Level) bool

func LogLevelColoredMsg

func LogLevelColoredMsg(lvl Level, msg string) string

func LogLevelString

func LogLevelString(lvl Level) string

func Logf

func Logf(lvl Level, format string, args ...interface{})

func Logv

func Logv(lvl Level, args ...interface{})

func PaddedString

func PaddedString(s string, width int) string

func SetFilter

func SetFilter(logger *Logger, filter func(Level) bool)

func SetFlags

func SetFlags(logger *Logger, flags loggerFlags)

func SetLogger

func SetLogger(l *Logger)

func Trace

func Trace(message string)

func TraceLevelFilter

func TraceLevelFilter(lvl Level) bool

func Tracef

func Tracef(format string, args ...interface{})

func Tracev

func Tracev(args ...interface{})

func Warn

func Warn(message string)

func WarnLevelFilter

func WarnLevelFilter(lvl Level) bool

func Warnf

func Warnf(format string, args ...interface{})

func Warnv

func Warnv(args ...interface{})

Types

type ColorStringer

type ColorStringer interface {
	ColorString() string
}

type Field

type Field struct {
	Name  string
	Value interface{}
}

func GetFields

func GetFields(logger *Logger) []Field

type Level

type Level uint

func LogLevelFromString

func LogLevelFromString(level string) Level

type LeveledSink

type LeveledSink struct {
	MaxLevel Level
	Inner    Sink
}

func (*LeveledSink) Flush

func (l *LeveledSink) Flush()

func (*LeveledSink) Log

func (l *LeveledSink) Log(r *Record)

type LogWriter

type LogWriter struct {
	WriteLevel Level
	Prefix     string
	// contains filtered or unexported fields
}

func NewLogWriter

func NewLogWriter(l *Logger, lvl Level, prefix string) *LogWriter

func (*LogWriter) Write

func (s *LogWriter) Write(p []byte) (n int, err error)

type Logger

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

func GetLogger

func GetLogger() *Logger

func New

func New(sink Sink) *Logger

func With

func With(name string, val interface{}) *Logger

func WithFields

func WithFields(fields []Field) *Logger

func (*Logger) Debug

func (l *Logger) Debug(message string)

func (*Logger) Debugf

func (l *Logger) Debugf(format string, args ...interface{})

func (*Logger) Debugv

func (l *Logger) Debugv(args ...interface{})

func (*Logger) Error

func (l *Logger) Error(message string)

func (*Logger) Errorf

func (l *Logger) Errorf(format string, args ...interface{})

func (*Logger) Errorv

func (l *Logger) Errorv(args ...interface{})

func (*Logger) Flush

func (l *Logger) Flush()

func (*Logger) Info

func (l *Logger) Info(message string)

func (*Logger) Infof

func (l *Logger) Infof(format string, args ...interface{})

func (*Logger) Infov

func (l *Logger) Infov(args ...interface{})

func (*Logger) IsEnabled

func (l *Logger) IsEnabled(lvl Level) bool

func (*Logger) Log

func (l *Logger) Log(lvl Level, message string)

func (*Logger) Logf

func (l *Logger) Logf(lvl Level, format string, args ...interface{})

func (*Logger) Logv

func (l *Logger) Logv(lvl Level, args ...interface{})

func (*Logger) Trace

func (l *Logger) Trace(message string)

func (*Logger) Tracef

func (l *Logger) Tracef(format string, args ...interface{})

func (*Logger) Tracev

func (l *Logger) Tracev(args ...interface{})

func (*Logger) Warn

func (l *Logger) Warn(message string)

func (*Logger) Warnf

func (l *Logger) Warnf(format string, args ...interface{})

func (*Logger) Warnv

func (l *Logger) Warnv(args ...interface{})

func (*Logger) With

func (l *Logger) With(name string, value interface{}) *Logger

func (*Logger) WithFields

func (l *Logger) WithFields(fields []Field) *Logger

type Metadata

type Metadata struct {
	Logger *Logger
	Level  Level
	Time   time.Time
	File   string
	Line   int
}

type MultiSink

type MultiSink []Sink

func (MultiSink) Flush

func (m MultiSink) Flush()

func (MultiSink) Log

func (m MultiSink) Log(r *Record)

type NopSink

type NopSink struct{}

func (NopSink) Flush

func (NopSink) Flush()

func (NopSink) Log

func (NopSink) Log(*Record)

type Record

type Record struct {
	Meta   Metadata
	Format string
	Args   []interface{}
}

type Sink

type Sink interface {
	Log(*Record)
	Flush()
}

func CreateMultiSink

func CreateMultiSink(recs ...Sink) Sink

func GetSink

func GetSink(logger *Logger) Sink

type StreamSink

type StreamSink struct {
	Formatter func(*Record) string
	Stream    io.Writer
}

func (*StreamSink) Flush

func (s *StreamSink) Flush()

func (*StreamSink) Log

func (s *StreamSink) Log(r *Record)

type SyncedSink

type SyncedSink struct {
	Inner Sink
	// contains filtered or unexported fields
}

func (*SyncedSink) Flush

func (s *SyncedSink) Flush()

func (*SyncedSink) Log

func (s *SyncedSink) Log(r *Record)