go.uber.org/zap

Enhancements:

• #751: Migrate to Go modules.

Enhancements:

• #725: Add zapcore.OmitKey to omit keys in an EncoderConfig.
• #736: Add RFC3339 and RFC3339Nano time encoders.

Thanks to @juicemia, @uhthomas for their contributions to this release.

Bugfixes:

• #657: Fix MapObjectEncoder.AppendByteString not adding value as a string.
• #706: Fix incorrect call depth to determine caller in Go 1.12.

Enhancements:

• #610: Add zaptest.WrapOptions to wrap zap.Option for creating test loggers.
• #675: Don't panic when encoding a String field.
• #704: Disable HTML escaping for JSON objects encoded using the reflect-based encoder.

Thanks to @iaroslav-ciupin, @lelenanam, @joa, @NWilson for their contributions to this release.

Bugfixes:

• #614: MapObjectEncoder should not ignore empty slices.

Enhancements:

• #602: Reduce number of allocations when logging with reflection.
• #572, #606: Expose a registry for third-party logging sinks.

Thanks to @nfarah86, @AlekSi, @JeanMertz, @philippgille, @etsangsplk, and @dimroc for their contributions to this release.

Enhancements:

• #508: Make log level configurable when redirecting the standard library's logger.
• #518: Add a logger that writes to a *testing.TB.
• #577: Add a top-level alias for zapcore.Field to clean up GoDoc.

Bugfixes:

• #574: Add a missing import comment to go.uber.org/zap/buffer.

Thanks to @DiSiqueira and @djui for their contributions to this release.

Bugfixes:

• #504: Store strings when using AddByteString with the map encoder.

Enhancements:

• #487: Add NewStdLogAt, which extends NewStdLog by allowing the user to specify the level of the logged messages.

Enhancements:

• #491: Omit zap stack frames from stacktraces.
• #490: Add a ContextMap method to observer logs for simpler field validation in tests.

Enhancements:

• #460 and #470: Support errors produced by go.uber.org/multierr.
• #465: Support user-supplied encoders for logger names.

Bugfixes:

• #477: Fix a bug that incorrectly truncated deep stacktraces.

Thanks to @richard-tunein and @pavius for their contributions to this release.

This release fixes two bugs.

Bugfixes:

• #435: Support a variety of case conventions when unmarshaling levels.
• #444: Fix a panic in the observer.

This release adds a few small features and is fully backward-compatible.

Enhancements:

• #424: Add a LineEnding field to EncoderConfig, allowing users to override the Unix-style default.
• #425: Preserve time zones when logging times.
• #431: Make zap.AtomicLevel implement fmt.Stringer, which makes a variety of operations a bit simpler.

This release adds an enhancement to zap's testing helpers as well as the ability to marshal an AtomicLevel. It is fully backward-compatible.

Enhancements:

• #415: Add a substring-filtering helper to zap's observer. This is particularly useful when testing the SugaredLogger.
• #416: Make AtomicLevel implement encoding.TextMarshaler.

This release adds a gRPC compatibility wrapper. It is fully backward-compatible.

Enhancements:

• #402: Add a zapgrpc package that wraps zap's Logger and implements grpclog.Logger.

This release fixes two bugs and adds some enhancements to zap's testing helpers. It is fully backward-compatible.

Bugfixes:

• #385: Fix caller path trimming on Windows.
• #396: Fix a panic when attempting to use non-existent directories with zap's configuration struct.

Enhancements:

• #386: Add filtering helpers to zaptest's observing logger.

Thanks to @moitias for contributing to this release.

This is zap's first stable release. All exported APIs are now final, and no further breaking changes will be made in the 1.x release series. Anyone using a semver-aware dependency manager should now pin to ^1.

Breaking changes:

• #366: Add byte-oriented APIs to encoders to log UTF-8 encoded text without casting from []byte to string.
• #364: To support buffering outputs, add Sync methods to zapcore.Core, zap.Logger, and zap.SugaredLogger.
• #371: Rename the testutils package to zaptest, which is less likely to clash with other testing helpers.

Bugfixes:

• #362: Make the ISO8601 time formatters fixed-width, which is friendlier for tab-separated console output.
• #369: Remove the automatic locks in zapcore.NewCore, which allows zap to work with concurrency-safe WriteSyncer implementations.
• #347: Stop reporting errors when trying to fsync standard out on Linux systems.
• #373: Report the correct caller from zap's standard library interoperability wrappers.

Enhancements:

• #348: Add a registry allowing third-party encodings to work with zap's built-in Config.
• #327: Make the representation of logger callers configurable (like times, levels, and durations).
• #376: Allow third-party encoders to use their own buffer pools, which removes the last performance advantage that zap's encoders have over plugins.
• #346: Add CombineWriteSyncers, a convenience function to tee multiple WriteSyncers and lock the result.
• #365: Make zap's stacktraces compatible with mid-stack inlining (coming in Go 1.9).
• #372: Export zap's observing logger as zaptest/observer. This makes it easier for particularly punctilious users to unit test their application's logging.

Thanks to @suyash, @htrendev, @flisky, @Ulexus, and @skipor for their contributions to this release.