loggers

Documentation

Overview

package loggers contains some basic logging setup.

Index

• Variables
• func LevelLoggerToWriter(l logg.LevelLogger) io.Writer
• func SetGlobalLogger(logger Logger)
• func TimeTrackf(l logg.LevelLogger, start time.Time, fields logg.Fields, format string, ...)
• func TimeTrackfn(fn func() (logg.LevelLogger, error)) error
• type Logger
  • func Log() Logger
  • func New(opts Options) Logger
  • func NewDefault() Logger
  • func NewTrace() Logger
• type Options

Variables

var (

	// FieldNameCmd is the name of the field that holds the command name.
	FieldNameCmd = reservedFieldNamePrefix + "_cmd"
	// Used to suppress statements.
	FieldNameStatementID = reservedFieldNamePrefix + "__h_field_statement_id"
)

var PanicOnWarningHook = func(e *logg.Entry) error {
	if e.Level != logg.LevelWarn {
		return nil
	}
	panic(e.Message)
}

PanicOnWarningHook panics on warnings.

Functions

func LevelLoggerToWriter

func LevelLoggerToWriter(l logg.LevelLogger) io.Writer

func SetGlobalLogger

func SetGlobalLogger(logger Logger)

SetGlobalLogger sets the global logger. This is used in a few places in Hugo, e.g. deprecated functions.

func TimeTrackf

func TimeTrackf(l logg.LevelLogger, start time.Time, fields logg.Fields, format string, a ...any)

func TimeTrackfn

func TimeTrackfn(fn func() (logg.LevelLogger, error)) error

Types

type Logger

type Logger interface {
	Debug() logg.LevelLogger
	Debugf(format string, v ...any)
	Debugln(v ...any)
	Error() logg.LevelLogger
	Errorf(format string, v ...any)
	Erroridf(id, format string, v ...any)
	Errorln(v ...any)
	Errors() string
	Info() logg.LevelLogger
	InfoCommand(command string) logg.LevelLogger
	Infof(format string, v ...any)
	Infoln(v ...any)
	Level() logg.Level
	LoggCount(logg.Level) int
	Logger() logg.Logger
	StdOut() io.Writer
	StdErr() io.Writer
	Printf(format string, v ...any)
	Println(v ...any)
	PrintTimerIfDelayed(start time.Time, name string)
	Reset()
	Warn() logg.LevelLogger
	WarnCommand(command string) logg.LevelLogger
	Warnf(format string, v ...any)
	Warnidf(id, format string, v ...any)
	Warnln(v ...any)
	Deprecatef(fail bool, format string, v ...any)
	Trace(s logg.StringFunc)
}

func Log

func Log() Logger

func New

func New(opts Options) Logger

New creates a new logger with the given options.

func NewDefault

func NewDefault() Logger

NewDefault creates a new logger with the default options.

func NewTrace

func NewTrace() Logger

type Options

type Options struct {
	Level              logg.Level
	StdOut             io.Writer
	StdErr             io.Writer
	DistinctLevel      logg.Level
	StoreErrors        bool
	HandlerPost        func(e *logg.Entry) error
	SuppressStatements map[string]bool
}

Options defines options for the logger.