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
estimateInfoLenand use this for message padding inflush()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, handlerMods ...logmods.HandlerMod) log.Logger
- func WrapCaptureLogger(h slog.Handler) slog.Handler
- type CapturedAttributes
- type CapturedRecord
- type Capturer
- type CapturingHandler
- func (c *CapturingHandler) Clear()
- func (c *CapturingHandler) Enabled(ctx context.Context, level slog.Level) bool
- func (c *CapturingHandler) FindLog(filters ...LogFilter) *CapturedRecord
- func (c *CapturingHandler) FindLogs(filters ...LogFilter) []*CapturedRecord
- func (c *CapturingHandler) Handle(ctx context.Context, r slog.Record) error
- func (c *CapturingHandler) Unwrap() slog.Handler
- func (c *CapturingHandler) WithAttrs(attrs []slog.Attr) slog.Handler
- func (c *CapturingHandler) WithGroup(name string) slog.Handler
- type LogFilter
- func NewAttributesContainsFilter(key, value string) LogFilter
- func NewAttributesFilter(key, value string) LogFilter
- func NewErrContainsFilter(errMessage string) LogFilter
- func NewLevelFilter(level slog.Level) LogFilter
- func NewMessageContainsFilter(message string) LogFilter
- func NewMessageFilter(message string) LogFilter
- type Testing
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func LoggerWithHandlerMod ¶ added in v1.5.1
Types ¶
type CapturedAttributes ¶ added in v1.9.1
type CapturedAttributes struct {
Parent *CapturedAttributes
Attributes []slog.Attr
}
CapturedAttributes forms a chain of inherited attributes, to traverse on captured log records.
func (*CapturedAttributes) Attrs ¶ added in v1.9.1
func (r *CapturedAttributes) Attrs(f func(slog.Attr) bool)
Attrs calls f on each Attr in the CapturedAttributes. Iteration stops if f returns false.
type CapturedRecord ¶ added in v1.9.1
type CapturedRecord struct {
Parent *CapturedAttributes
*slog.Record
}
CapturedRecord is a wrapped around a regular log-record, to preserve the inherited attributes context, without mutating the record or reordering attributes.
func (*CapturedRecord) AttrValue ¶ added in v1.9.1
func (h *CapturedRecord) AttrValue(name string) (v any)
func (*CapturedRecord) Attrs ¶ added in v1.9.1
func (r *CapturedRecord) Attrs(f func(slog.Attr) bool)
Attrs calls f on each Attr in the CapturedRecord. Iteration stops if f returns false.
type Capturer ¶ added in v1.13.4
type Capturer interface {
slog.Handler
Clear()
FindLog(filters ...LogFilter) *CapturedRecord
FindLogs(filters ...LogFilter) []*CapturedRecord
}
type CapturingHandler ¶
type CapturingHandler struct {
Logs *[]*CapturedRecord // 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 ¶ added in v1.5.1
func (*CapturingHandler) Clear ¶
func (c *CapturingHandler) Clear()
func (*CapturingHandler) FindLog ¶
func (c *CapturingHandler) FindLog(filters ...LogFilter) *CapturedRecord
func (*CapturingHandler) FindLogs ¶ added in v1.6.1
func (c *CapturingHandler) FindLogs(filters ...LogFilter) []*CapturedRecord
func (*CapturingHandler) Unwrap ¶ added in v1.13.4
func (c *CapturingHandler) Unwrap() slog.Handler
type LogFilter ¶ added in v1.6.1
type LogFilter func(record *CapturedRecord) bool
func NewAttributesContainsFilter ¶ added in v1.7.2
func NewAttributesFilter ¶ added in v1.7.2
func NewErrContainsFilter ¶ added in v1.13.1
func NewLevelFilter ¶ added in v1.6.1
func NewMessageContainsFilter ¶ added in v1.6.1
func NewMessageFilter ¶ added in v1.6.1
type Testing ¶
type Testing interface {
Logf(format string, args ...any)
Helper()
FailNow()
Name() string
Cleanup(func())
}
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.
Source Files