testlog

README

testlog

github.com/ethereum/go-ethereum/internal/testlog: a Go-ethereum util for logging in tests.

Since we use the same logging, but as an external package, we have to move the test utility to our own internal package.

This fork also made minor modifications:

• Enable color by default.
• Add estimateInfoLen and use this for message padding in flush() to align the contents of the log entries, compensating for the different lengths of the log decoration that the Go library adds.

Documentation

Overview

Package testlog provides a log handler for unit tests.

Index

• func Logger(t Testing, level slog.Level) log.Logger
• func LoggerWithHandlerMod(t Testing, level slog.Level, handlerMod func(slog.Handler) slog.Handler) log.Logger
• type CapturingHandler
  • func CaptureLogger(t Testing, level slog.Level) (_ log.Logger, ch *CapturingHandler)
  • func (c *CapturingHandler) Clear()
  • func (c *CapturingHandler) Enabled(context.Context, slog.Level) bool
  • func (c *CapturingHandler) FindLog(filters ...LogFilter) *HelperRecord
  • func (c *CapturingHandler) FindLogs(filters ...LogFilter) []*HelperRecord
  • func (c *CapturingHandler) Handle(ctx context.Context, r slog.Record) error
  • func (c *CapturingHandler) WithAttrs(attrs []slog.Attr) slog.Handler
  • func (c *CapturingHandler) WithGroup(name string) slog.Handler
• type HelperRecord
  • func (h HelperRecord) AttrValue(name string) (v any)
• type LogFilter
  • func NewAttributesContainsFilter(key, value string) LogFilter
  • func NewAttributesFilter(key, value string) LogFilter
  • func NewLevelFilter(level slog.Level) LogFilter
  • func NewMessageContainsFilter(message string) LogFilter
  • func NewMessageFilter(message string) LogFilter
• type Testing

Functions

func Logger

func Logger(t Testing, level slog.Level) log.Logger

Logger returns a logger which logs to the unit test log of t.

func LoggerWithHandlerMod

func LoggerWithHandlerMod(t Testing, level slog.Level, handlerMod func(slog.Handler) slog.Handler) log.Logger

Types

type CapturingHandler

type CapturingHandler struct {
	Logs *[]*slog.Record // shared among derived CapturingHandlers
	// contains filtered or unexported fields
}

CapturingHandler provides a log handler that captures all log records and optionally forwards them to a delegate. Note that it is not thread safe.

func CaptureLogger

func CaptureLogger(t Testing, level slog.Level) (_ log.Logger, ch *CapturingHandler)

func (*CapturingHandler) Clear

func (c *CapturingHandler) Clear()

func (*CapturingHandler) Enabled

func (c *CapturingHandler) Enabled(context.Context, slog.Level) bool

func (*CapturingHandler) FindLog

func (c *CapturingHandler) FindLog(filters ...LogFilter) *HelperRecord

func (*CapturingHandler) FindLogs

func (c *CapturingHandler) FindLogs(filters ...LogFilter) []*HelperRecord

func (*CapturingHandler) Handle

func (c *CapturingHandler) Handle(ctx context.Context, r slog.Record) error

func (*CapturingHandler) WithAttrs

func (c *CapturingHandler) WithAttrs(attrs []slog.Attr) slog.Handler

func (*CapturingHandler) WithGroup

func (c *CapturingHandler) WithGroup(name string) slog.Handler

type HelperRecord

type HelperRecord struct {
	*slog.Record
}

func (HelperRecord) AttrValue

func (h HelperRecord) AttrValue(name string) (v any)

type LogFilter

type LogFilter func(*slog.Record) bool

func NewAttributesContainsFilter

func NewAttributesContainsFilter(key, value string) LogFilter

func NewAttributesFilter

func NewAttributesFilter(key, value string) LogFilter

func NewLevelFilter

func NewLevelFilter(level slog.Level) LogFilter

func NewMessageContainsFilter

func NewMessageContainsFilter(message string) LogFilter

func NewMessageFilter

func NewMessageFilter(message string) LogFilter

type Testing

type Testing interface {
	Logf(format string, args ...any)
	Helper()
}

Testing interface to log to. Some functions are marked as Helper function to log the call site accurately. Standard Go testing.TB implements this, as well as Hive and other Go-like test frameworks.