logging

Documentation

Index

• func Error(err error) slog.Attr
• func NewLogger(opts ...LoggingOptions) *slog.Logger
• func NewNullLogger() *slog.Logger
• type LoggingOptions
  • func (o LoggingOptions) Handler() slog.Handler
• type NullHandler
  • func (h NullHandler) Enabled(_ context.Context, _ slog.Level) bool
  • func (h NullHandler) Handle(_ context.Context, _ slog.Record) error
  • func (h NullHandler) WithAttrs(_ []slog.Attr) slog.Handler
  • func (h NullHandler) WithGroup(_ string) slog.Handler
• type TeeHandler
  • func NewTeeHandler(handlers ...slog.Handler) *TeeHandler
  • func (h *TeeHandler) Enabled(ctx context.Context, lvl slog.Level) bool
  • func (h *TeeHandler) Handle(ctx context.Context, record slog.Record) error
  • func (h *TeeHandler) WithAttrs(attrs []slog.Attr) slog.Handler
  • func (h *TeeHandler) WithGroup(name string) slog.Handler

Functions

func Error

func Error(err error) slog.Attr

func NewLogger

func NewLogger(opts ...LoggingOptions) *slog.Logger

func NewNullLogger

func NewNullLogger() *slog.Logger

Types

type LoggingOptions

type LoggingOptions struct {
	// Filepath | "" or "stderr" for stderr | "stdout" for stdout (default "")
	Target string
	// adds a "2006_01_02_15_04_05" timestamp to the log file name
	// Not compatible with stderr/stdout (default false)
	PrefixFilenameWithTime bool
	// Whether to add the source location of the call to log (default false)
	AddSource bool
	// Minimum level to log for this handler (default INFO)
	Level slog.Level
	// false means TextHandler, true means JsonHandler
	// overridden by CustomHandler (default false)
	JsonHandler bool
	// ReplaceAttrs are called to rewrite each attribute before it is logged. (default nil)
	ReplaceAttrs []func(attrGroups []string, a slog.Attr) slog.Attr
	// Your custom handler, overrides all other fields (default nil)
	CustomHandler slog.Handler
}

LoggingOptions describes a handler

func (LoggingOptions) Handler

func (o LoggingOptions) Handler() slog.Handler

Handler instantiates a new handle based on the requested options

type NullHandler

type NullHandler sets.Unit

func (NullHandler) Enabled

func (h NullHandler) Enabled(_ context.Context, _ slog.Level) bool

func (NullHandler) Handle

func (h NullHandler) Handle(_ context.Context, _ slog.Record) error

func (NullHandler) WithAttrs

func (h NullHandler) WithAttrs(_ []slog.Attr) slog.Handler

func (NullHandler) WithGroup

func (h NullHandler) WithGroup(_ string) slog.Handler

type TeeHandler

type TeeHandler struct {
	Handlers []slog.Handler
}

func NewTeeHandler

func NewTeeHandler(handlers ...slog.Handler) *TeeHandler

func (*TeeHandler) Enabled

func (h *TeeHandler) Enabled(ctx context.Context, lvl slog.Level) bool

func (*TeeHandler) Handle

func (h *TeeHandler) Handle(ctx context.Context, record slog.Record) error

func (*TeeHandler) WithAttrs

func (h *TeeHandler) WithAttrs(attrs []slog.Attr) slog.Handler

func (*TeeHandler) WithGroup

func (h *TeeHandler) WithGroup(name string) slog.Handler