zlog

Documentation

Index

• Constants
• Variables
• func AddToContext(ctx context.Context, attrs ...slog.Attr) context.Context
• func ContextMiddleware(ctx context.Context, r slog.Record) (context.Context, slog.Record)
• func FormatError(a slog.Attr) slog.Attr
• func MultiReplaceAttribute(fns ...func(slog.Attr) slog.Attr) func(slog.Attr) slog.Attr
• func New(opts ...Options) *slog.Logger
• func NewLevels(a slog.Attr) slog.Attr
• func SetLevel(ctx context.Context, level slog.Level) context.Context
• type ColorScheme
• type Format
• type Middleware
  • func ReplaceAttributeMiddleware(fn func(slog.Attr) slog.Attr) Middleware
• type Options
• type Sink
• type Style

Constants

const (
	LevelTrace = slog.Level(-8 + 4*iota)
	LevelDebug
	LevelInfo
	LevelWarn
	LevelError
	LevelPanic
	LevelFatal
)

Variables

var DefaultStyle = Style{
	Format:     FormatPretty,
	TimeFormat: "[_2/01 15:04:05Z07]",
	Colors: ColorScheme{
		Levels: map[slog.Level]*color.Color{
			LevelTrace: color.RGB(67, 120, 198),
			LevelDebug: color.RGB(65, 185, 198),
			LevelInfo:  color.RGB(134, 180, 249),
			LevelWarn:  color.RGB(252, 172, 75),
			LevelError: color.RGB(252, 99, 75),
			LevelPanic: color.RGB(216, 52, 0),
			LevelFatal: color.RGB(73, 0, 0),
		},
		Time:    color.New(color.FgCyan, color.Italic),
		Message: color.RGB(170, 170, 170),
		Body:    color.New(color.FgHiWhite, color.Italic),
	},
}

var JSONStyle = Style{
	Format:     FormatJSON,
	TimeFormat: time.RFC3339,
}

Functions

func AddToContext

func AddToContext(ctx context.Context, attrs ...slog.Attr) context.Context

AddToContext stores slog attributes in the context for injection by ContextMiddleware.

func ContextMiddleware

func ContextMiddleware(ctx context.Context, r slog.Record) (context.Context, slog.Record)

ContextMiddleware pulls slog attributes stored in the context and injects them into the record. Use AddToContext to attach attributes to a context.

func FormatError

func FormatError(a slog.Attr) slog.Attr

FormatError is a replaceAttr-compatible function that expands error attributes into a group with msg, cause, and stack frames.

func MultiReplaceAttribute

func MultiReplaceAttribute(fns ...func(slog.Attr) slog.Attr) func(slog.Attr) slog.Attr

func New

func New(opts ...Options) *slog.Logger

New creates a *slog.Logger. Without arguments, outputs colored pretty-print to stdout.

func NewLevels

func NewLevels(a slog.Attr) slog.Attr

NewLevels is a function that maps custom level values to their names.

func SetLevel

func SetLevel(ctx context.Context, level slog.Level) context.Context

SetLevel stores a dynamic minimum log level in the context. The handler will use this level instead of its configured minimum.

Types

type ColorScheme

type ColorScheme struct {
	Levels  map[slog.Level]*color.Color
	Time    *color.Color
	Message *color.Color
	Body    *color.Color
}

ColorScheme defines the color palette.

type Format

type Format int

Format controls how log lines are rendered.

const (
	FormatPretty Format = iota
	FormatJSON
)

type Middleware

type Middleware func(ctx context.Context, r slog.Record) (context.Context, slog.Record)

Middleware is the unified pipeline type that replaces both modifiers and replaceAttr functions.

func ReplaceAttributeMiddleware

func ReplaceAttributeMiddleware(fn func(slog.Attr) slog.Attr) Middleware

ReplaceAttributeMiddleware adapts a per-attribute transform function into a Middleware.

type Options

type Options struct {
	// Middleware is applied globally to every record before routing to sinks.
	Middleware []Middleware
	// Sinks defines output destinations.
	Sinks []Sink
}

Options configures the logger.

type Sink

type Sink struct {
	Writer io.Writer
	Level  slog.Level
	Style  Style
}

Sink configures a single log output destination.

type Style

type Style struct {
	Format     Format
	TimeFormat string
	Colors     ColorScheme
}

Style controls the visual presentation of a log sink.