logtest

func Captured ¶

func Captured(t testing.TB) (logger log.Logger, exportLogs func() CapturedLogs)

Captured retrieves a logger from scoped to the the given test, and returns a callback, dumpLogs, which flushes the logger buffer and returns log entries.

func Init ¶

func Init(_ *testing.M)

Init can be used to instantiate the log package for running tests, to be called in TestMain for the relevant package. Remember to call (*testing.M).Run() after initializing the logger!

testing.M is an unused argument, used to indicate this function should be called in TestMain.

func InitWithLevel ¶

func InitWithLevel(_ *testing.M, level log.Level)

InitWithLevel does the same thing as Init, but uses the provided log level to configur the log level for this package's tests, which can be helpful for exceptionally noisy tests.

If your loggers are parameterized, you can also use logtest.NoOp to silence output for specific tests.

func NoOp ¶

func NoOp(_ *testing.T) log.Logger

NoOp returns a no-op Logger, useful for silencing all output in a specific test.

func Scoped ¶

func Scoped(t testing.TB) log.Logger

Scoped retrieves a logger scoped to the the given test. It writes to testing.TB.

Unlike log.Scoped(), logtest.Scoped() is safe to use without initialization.

func ScopedWith ¶

func ScopedWith(t testing.TB, options LoggerOptions) log.Logger

Scoped retrieves a logger scoped to the the given test, configured with additional options. It writes to testing.TB.

Unlike log.Scoped(), logtest.Scoped() is safe to use without initialization.