logger

Documentation

Overview

Package logger implements a standardized logger with callback functionality

Index

• Constants
• Variables
• type Line
• type LogLevel
• type Logger
  • func New() Logger
• type MessageHandler
• type Recorder
  • func NewRecorder(l Logger, level LogLevel, size, initial int) Recorder

Constants

const (
	DefaultFlags = log.Ltime | log.Ldate
	DebugFlags   = log.Ltime | log.Ldate | log.Lmicroseconds | log.Lshortfile
)

Variables

var DefaultLogger = New()

DefaultLogger logs to standard output with a time prefix.

Types

type Line

type Line struct {
	When    time.Time `json:"when"`
	Message string    `json:"message"`
	Level   LogLevel  `json:"level"`
}

A Line represents a single log entry.

type LogLevel

type LogLevel int

const (
	LevelDebug LogLevel = iota
	LevelVerbose
	LevelInfo
	LevelWarn
	NumLevels
)

type Logger

type Logger interface {
	AddHandler(level LogLevel, h MessageHandler)
	SetFlags(flag int)
	SetPrefix(prefix string)
	Debugln(vals ...interface{})
	Debugf(format string, vals ...interface{})
	Verboseln(vals ...interface{})
	Verbosef(format string, vals ...interface{})
	Infoln(vals ...interface{})
	Infof(format string, vals ...interface{})
	Warnln(vals ...interface{})
	Warnf(format string, vals ...interface{})
	ShouldDebug(facility string) bool
	SetDebug(facility string, enabled bool)
	Facilities() map[string]string
	FacilityDebugging() []string
	NewFacility(facility, description string) Logger
}

func New

func New() Logger

type MessageHandler

type MessageHandler func(l LogLevel, msg string)

A MessageHandler is called with the log level and message text.

type Recorder

type Recorder interface {
	Since(t time.Time) []Line
	Clear()
}

A Recorder keeps a size limited record of log events.

func NewRecorder

func NewRecorder(l Logger, level LogLevel, size, initial int) Recorder