...

Package observer

import "go.uber.org/zap/zaptest/observer"
Overview
Index

Overview ▾

Package observer provides a zapcore.Core that keeps an in-memory, encoding-agnostic representation of log entries. It's useful for applications that want to unit test their log output without tying their tests to a particular output encoding.

type LoggedEntry

An LoggedEntry is an encoding-agnostic representation of a log message. Field availability is context dependant.

type LoggedEntry struct {
    zapcore.Entry
    Context []zapcore.Field
}

func (LoggedEntry) ContextMap

func (e LoggedEntry) ContextMap() map[string]interface{}

ContextMap returns a map for all fields in Context.

type ObservedLogs

ObservedLogs is a concurrency-safe, ordered collection of observed logs.

type ObservedLogs struct {
    // contains filtered or unexported fields
}

func New

func New(enab zapcore.LevelEnabler) (zapcore.Core, *ObservedLogs)

New creates a new Core that buffers logs in memory (without any encoding). It's particularly useful in tests.

func (*ObservedLogs) All

func (o *ObservedLogs) All() []LoggedEntry

All returns a copy of all the observed logs.

func (*ObservedLogs) AllUntimed

func (o *ObservedLogs) AllUntimed() []LoggedEntry

AllUntimed returns a copy of all the observed logs, but overwrites the observed timestamps with time.Time's zero value. This is useful when making assertions in tests.

func (*ObservedLogs) Filter

func (o *ObservedLogs) Filter(keep func(LoggedEntry) bool) *ObservedLogs

Filter returns a copy of this ObservedLogs containing only those entries for which the provided function returns true.

func (*ObservedLogs) FilterField

func (o *ObservedLogs) FilterField(field zapcore.Field) *ObservedLogs

FilterField filters entries to those that have the specified field.

func (*ObservedLogs) FilterFieldKey

func (o *ObservedLogs) FilterFieldKey(key string) *ObservedLogs

FilterFieldKey filters entries to those that have the specified key.

func (*ObservedLogs) FilterLevelExact

func (o *ObservedLogs) FilterLevelExact(level zapcore.Level) *ObservedLogs

FilterLevelExact filters entries to those logged at exactly the given level.

func (*ObservedLogs) FilterMessage

func (o *ObservedLogs) FilterMessage(msg string) *ObservedLogs

FilterMessage filters entries to those that have the specified message.

func (*ObservedLogs) FilterMessageSnippet

func (o *ObservedLogs) FilterMessageSnippet(snippet string) *ObservedLogs

FilterMessageSnippet filters entries to those that have a message containing the specified snippet.

func (*ObservedLogs) Len

func (o *ObservedLogs) Len() int

Len returns the number of items in the collection.

func (*ObservedLogs) TakeAll

func (o *ObservedLogs) TakeAll() []LoggedEntry

TakeAll returns a copy of all the observed logs, and truncates the observed slice.