306 lines
11 KiB
Markdown
306 lines
11 KiB
Markdown
# Changelog
|
|
|
|
## v1.9.1 (06 Aug 2018)
|
|
|
|
Bugfixes:
|
|
|
|
* [#614][]: MapObjectEncoder should not ignore empty slices.
|
|
|
|
## v1.9.0 (19 Jul 2018)
|
|
|
|
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.
|
|
|
|
## v1.8.0 (13 Apr 2018)
|
|
|
|
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.
|
|
|
|
## v1.7.1 (25 Sep 2017)
|
|
|
|
Bugfixes:
|
|
* [#504][]: Store strings when using AddByteString with the map encoder.
|
|
|
|
## v1.7.0 (21 Sep 2017)
|
|
|
|
Enhancements:
|
|
|
|
* [#487][]: Add `NewStdLogAt`, which extends `NewStdLog` by allowing the user
|
|
to specify the level of the logged messages.
|
|
|
|
## v1.6.0 (30 Aug 2017)
|
|
|
|
Enhancements:
|
|
|
|
* [#491][]: Omit zap stack frames from stacktraces.
|
|
* [#490][]: Add a `ContextMap` method to observer logs for simpler
|
|
field validation in tests.
|
|
|
|
## v1.5.0 (22 Jul 2017)
|
|
|
|
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.
|
|
|
|
## v1.4.1 (08 Jun 2017)
|
|
|
|
This release fixes two bugs.
|
|
|
|
Bugfixes:
|
|
|
|
* [#435][]: Support a variety of case conventions when unmarshaling levels.
|
|
* [#444][]: Fix a panic in the observer.
|
|
|
|
## v1.4.0 (12 May 2017)
|
|
|
|
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.
|
|
|
|
## v1.3.0 (25 Apr 2017)
|
|
|
|
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`.
|
|
|
|
## v1.2.0 (13 Apr 2017)
|
|
|
|
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`.
|
|
|
|
## v1.1.0 (31 Mar 2017)
|
|
|
|
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.
|
|
|
|
## v1.0.0 (14 Mar 2017)
|
|
|
|
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
|
|
`WriteSyncer`s 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.
|
|
|
|
## v1.0.0-rc.3 (7 Mar 2017)
|
|
|
|
This is the third release candidate for zap's stable release. There are no
|
|
breaking changes.
|
|
|
|
Bugfixes:
|
|
|
|
* [#339][]: Byte slices passed to `zap.Any` are now correctly treated as binary blobs
|
|
rather than `[]uint8`.
|
|
|
|
Enhancements:
|
|
|
|
* [#307][]: Users can opt into colored output for log levels.
|
|
* [#353][]: In addition to hijacking the output of the standard library's
|
|
package-global logging functions, users can now construct a zap-backed
|
|
`log.Logger` instance.
|
|
* [#311][]: Frames from common runtime functions and some of zap's internal
|
|
machinery are now omitted from stacktraces.
|
|
|
|
Thanks to @ansel1 and @suyash for their contributions to this release.
|
|
|
|
## v1.0.0-rc.2 (21 Feb 2017)
|
|
|
|
This is the second release candidate for zap's stable release. It includes two
|
|
breaking changes.
|
|
|
|
Breaking changes:
|
|
|
|
* [#316][]: Zap's global loggers are now fully concurrency-safe
|
|
(previously, users had to ensure that `ReplaceGlobals` was called before the
|
|
loggers were in use). However, they must now be accessed via the `L()` and
|
|
`S()` functions. Users can update their projects with
|
|
|
|
```
|
|
gofmt -r "zap.L -> zap.L()" -w .
|
|
gofmt -r "zap.S -> zap.S()" -w .
|
|
```
|
|
* [#309][] and [#317][]: RC1 was mistakenly shipped with invalid
|
|
JSON and YAML struct tags on all config structs. This release fixes the tags
|
|
and adds static analysis to prevent similar bugs in the future.
|
|
|
|
Bugfixes:
|
|
|
|
* [#321][]: Redirecting the standard library's `log` output now
|
|
correctly reports the logger's caller.
|
|
|
|
Enhancements:
|
|
|
|
* [#325][] and [#333][]: Zap now transparently supports non-standard, rich
|
|
errors like those produced by `github.com/pkg/errors`.
|
|
* [#326][]: Though `New(nil)` continues to return a no-op logger, `NewNop()` is
|
|
now preferred. Users can update their projects with `gofmt -r 'zap.New(nil) ->
|
|
zap.NewNop()' -w .`.
|
|
* [#300][]: Incorrectly importing zap as `github.com/uber-go/zap` now returns a
|
|
more informative error.
|
|
|
|
Thanks to @skipor and @chapsuk for their contributions to this release.
|
|
|
|
## v1.0.0-rc.1 (14 Feb 2017)
|
|
|
|
This is the first release candidate for zap's stable release. There are multiple
|
|
breaking changes and improvements from the pre-release version. Most notably:
|
|
|
|
* **Zap's import path is now "go.uber.org/zap"** — all users will
|
|
need to update their code.
|
|
* User-facing types and functions remain in the `zap` package. Code relevant
|
|
largely to extension authors is now in the `zapcore` package.
|
|
* The `zapcore.Core` type makes it easy for third-party packages to use zap's
|
|
internals but provide a different user-facing API.
|
|
* `Logger` is now a concrete type instead of an interface.
|
|
* A less verbose (though slower) logging API is included by default.
|
|
* Package-global loggers `L` and `S` are included.
|
|
* A human-friendly console encoder is included.
|
|
* A declarative config struct allows common logger configurations to be managed
|
|
as configuration instead of code.
|
|
* Sampling is more accurate, and doesn't depend on the standard library's shared
|
|
timer heap.
|
|
|
|
## v0.1.0-beta.1 (6 Feb 2017)
|
|
|
|
This is a minor version, tagged to allow users to pin to the pre-1.0 APIs and
|
|
upgrade at their leisure. Since this is the first tagged release, there are no
|
|
backward compatibility concerns and all functionality is new.
|
|
|
|
Early zap adopters should pin to the 0.1.x minor version until they're ready to
|
|
upgrade to the upcoming stable release.
|
|
|
|
[#316]: https://github.com/uber-go/zap/pull/316
|
|
[#309]: https://github.com/uber-go/zap/pull/309
|
|
[#317]: https://github.com/uber-go/zap/pull/317
|
|
[#321]: https://github.com/uber-go/zap/pull/321
|
|
[#325]: https://github.com/uber-go/zap/pull/325
|
|
[#333]: https://github.com/uber-go/zap/pull/333
|
|
[#326]: https://github.com/uber-go/zap/pull/326
|
|
[#300]: https://github.com/uber-go/zap/pull/300
|
|
[#339]: https://github.com/uber-go/zap/pull/339
|
|
[#307]: https://github.com/uber-go/zap/pull/307
|
|
[#353]: https://github.com/uber-go/zap/pull/353
|
|
[#311]: https://github.com/uber-go/zap/pull/311
|
|
[#366]: https://github.com/uber-go/zap/pull/366
|
|
[#364]: https://github.com/uber-go/zap/pull/364
|
|
[#371]: https://github.com/uber-go/zap/pull/371
|
|
[#362]: https://github.com/uber-go/zap/pull/362
|
|
[#369]: https://github.com/uber-go/zap/pull/369
|
|
[#347]: https://github.com/uber-go/zap/pull/347
|
|
[#373]: https://github.com/uber-go/zap/pull/373
|
|
[#348]: https://github.com/uber-go/zap/pull/348
|
|
[#327]: https://github.com/uber-go/zap/pull/327
|
|
[#376]: https://github.com/uber-go/zap/pull/376
|
|
[#346]: https://github.com/uber-go/zap/pull/346
|
|
[#365]: https://github.com/uber-go/zap/pull/365
|
|
[#372]: https://github.com/uber-go/zap/pull/372
|
|
[#385]: https://github.com/uber-go/zap/pull/385
|
|
[#396]: https://github.com/uber-go/zap/pull/396
|
|
[#386]: https://github.com/uber-go/zap/pull/386
|
|
[#402]: https://github.com/uber-go/zap/pull/402
|
|
[#415]: https://github.com/uber-go/zap/pull/415
|
|
[#416]: https://github.com/uber-go/zap/pull/416
|
|
[#424]: https://github.com/uber-go/zap/pull/424
|
|
[#425]: https://github.com/uber-go/zap/pull/425
|
|
[#431]: https://github.com/uber-go/zap/pull/431
|
|
[#435]: https://github.com/uber-go/zap/pull/435
|
|
[#444]: https://github.com/uber-go/zap/pull/444
|
|
[#477]: https://github.com/uber-go/zap/pull/477
|
|
[#465]: https://github.com/uber-go/zap/pull/465
|
|
[#460]: https://github.com/uber-go/zap/pull/460
|
|
[#470]: https://github.com/uber-go/zap/pull/470
|
|
[#487]: https://github.com/uber-go/zap/pull/487
|
|
[#490]: https://github.com/uber-go/zap/pull/490
|
|
[#491]: https://github.com/uber-go/zap/pull/491
|
|
[#504]: https://github.com/uber-go/zap/pull/504
|
|
[#508]: https://github.com/uber-go/zap/pull/508
|
|
[#518]: https://github.com/uber-go/zap/pull/518
|
|
[#577]: https://github.com/uber-go/zap/pull/577
|
|
[#574]: https://github.com/uber-go/zap/pull/574
|
|
[#602]: https://github.com/uber-go/zap/pull/602
|
|
[#572]: https://github.com/uber-go/zap/pull/572
|
|
[#606]: https://github.com/uber-go/zap/pull/606
|
|
[#614]: https://github.com/uber-go/zap/pull/614
|