zap: go.uber.org/zap/zaptest Index | Files | Directories

package zaptest

import "go.uber.org/zap/zaptest"

Package zaptest provides a variety of helpers for testing log output.

Index

Package Files

doc.go logger.go testingt.go timeout.go writer.go

func NewLogger Uses

func NewLogger(t TestingT, opts ...LoggerOption) *zap.Logger

NewLogger builds a new Logger that logs all messages to the given testing.TB.

logger := zaptest.NewLogger(t)

Use this with a *testing.T or *testing.B to get logs which get printed only if a test fails or if you ran go test -v.

The returned logger defaults to logging debug level messages and above. This may be changed by passing a zaptest.Level during construction.

logger := zaptest.NewLogger(t, zaptest.Level(zap.WarnLevel))

You may also pass zap.Option's to customize test logger.

logger := zaptest.NewLogger(t, zaptest.WrapOptions(zap.AddCaller()))

func Sleep Uses

func Sleep(base time.Duration)

Sleep scales the sleep duration by $TEST_TIMEOUT_SCALE.

Deprecated: This function is intended for internal testing and shouldn't be used outside zap itself. It was introduced before Go supported internal packages.

func Timeout Uses

func Timeout(base time.Duration) time.Duration

Timeout scales the provided duration by $TEST_TIMEOUT_SCALE.

Deprecated: This function is intended for internal testing and shouldn't be used outside zap itself. It was introduced before Go supported internal packages.

type Buffer Uses

type Buffer = ztest.Buffer

Buffer is an implementation of zapcore.WriteSyncer that sends all writes to a bytes.Buffer. It has convenience methods to split the accumulated buffer on newlines.

type Discarder Uses

type Discarder = ztest.Discarder

A Discarder sends all writes to ioutil.Discard.

type FailWriter Uses

type FailWriter = ztest.FailWriter

FailWriter is a WriteSyncer that always returns an error on writes.

type LoggerOption Uses

type LoggerOption interface {
    // contains filtered or unexported methods
}

LoggerOption configures the test logger built by NewLogger.

func Level Uses

func Level(enab zapcore.LevelEnabler) LoggerOption

Level controls which messages are logged by a test Logger built by NewLogger.

func WrapOptions Uses

func WrapOptions(zapOpts ...zap.Option) LoggerOption

WrapOptions adds zap.Option's to a test Logger built by NewLogger.

type ShortWriter Uses

type ShortWriter = ztest.ShortWriter

ShortWriter is a WriteSyncer whose write method never returns an error, but always reports that it wrote one byte less than the input slice's length (thus, a "short write").

type Syncer Uses

type Syncer = ztest.Syncer

A Syncer is a spy for the Sync portion of zapcore.WriteSyncer.

type TestingT Uses

type TestingT interface {
    // Logs the given message without failing the test.
    Logf(string, ...interface{})

    // Logs the given message and marks the test as failed.
    Errorf(string, ...interface{})

    // Marks the test as failed.
    Fail()

    // Returns true if the test has been marked as failed.
    Failed() bool

    // Returns the name of the test.
    Name() string

    // Marks the test as failed and stops execution of that test.
    FailNow()
}

TestingT is a subset of the API provided by all *testing.T and *testing.B objects.

Directories

PathSynopsis
observerPackage observer provides a zapcore.Core that keeps an in-memory, encoding-agnostic repesentation of log entries.

Package zaptest imports 5 packages (graph) and is imported by 3 packages. Updated 2018-11-22. Refresh now. Tools for package owners.