3 ## v1.9.1 (06 Aug 2018)
7 * [#614][]: MapObjectEncoder should not ignore empty slices.
9 ## v1.9.0 (19 Jul 2018)
12 * [#602][]: Reduce number of allocations when logging with reflection.
13 * [#572][], [#606][]: Expose a registry for third-party logging sinks.
15 Thanks to @nfarah86, @AlekSi, @JeanMertz, @philippgille, @etsangsplk, and
16 @dimroc for their contributions to this release.
18 ## v1.8.0 (13 Apr 2018)
21 * [#508][]: Make log level configurable when redirecting the standard
23 * [#518][]: Add a logger that writes to a `*testing.TB`.
24 * [#577][]: Add a top-level alias for `zapcore.Field` to clean up GoDoc.
27 * [#574][]: Add a missing import comment to `go.uber.org/zap/buffer`.
29 Thanks to @DiSiqueira and @djui for their contributions to this release.
31 ## v1.7.1 (25 Sep 2017)
34 * [#504][]: Store strings when using AddByteString with the map encoder.
36 ## v1.7.0 (21 Sep 2017)
40 * [#487][]: Add `NewStdLogAt`, which extends `NewStdLog` by allowing the user
41 to specify the level of the logged messages.
43 ## v1.6.0 (30 Aug 2017)
47 * [#491][]: Omit zap stack frames from stacktraces.
48 * [#490][]: Add a `ContextMap` method to observer logs for simpler
49 field validation in tests.
51 ## v1.5.0 (22 Jul 2017)
55 * [#460][] and [#470][]: Support errors produced by `go.uber.org/multierr`.
56 * [#465][]: Support user-supplied encoders for logger names.
60 * [#477][]: Fix a bug that incorrectly truncated deep stacktraces.
62 Thanks to @richard-tunein and @pavius for their contributions to this release.
64 ## v1.4.1 (08 Jun 2017)
66 This release fixes two bugs.
70 * [#435][]: Support a variety of case conventions when unmarshaling levels.
71 * [#444][]: Fix a panic in the observer.
73 ## v1.4.0 (12 May 2017)
75 This release adds a few small features and is fully backward-compatible.
79 * [#424][]: Add a `LineEnding` field to `EncoderConfig`, allowing users to
80 override the Unix-style default.
81 * [#425][]: Preserve time zones when logging times.
82 * [#431][]: Make `zap.AtomicLevel` implement `fmt.Stringer`, which makes a
83 variety of operations a bit simpler.
85 ## v1.3.0 (25 Apr 2017)
87 This release adds an enhancement to zap's testing helpers as well as the
88 ability to marshal an AtomicLevel. It is fully backward-compatible.
92 * [#415][]: Add a substring-filtering helper to zap's observer. This is
93 particularly useful when testing the `SugaredLogger`.
94 * [#416][]: Make `AtomicLevel` implement `encoding.TextMarshaler`.
96 ## v1.2.0 (13 Apr 2017)
98 This release adds a gRPC compatibility wrapper. It is fully backward-compatible.
102 * [#402][]: Add a `zapgrpc` package that wraps zap's Logger and implements
105 ## v1.1.0 (31 Mar 2017)
107 This release fixes two bugs and adds some enhancements to zap's testing helpers.
108 It is fully backward-compatible.
112 * [#385][]: Fix caller path trimming on Windows.
113 * [#396][]: Fix a panic when attempting to use non-existent directories with
114 zap's configuration struct.
118 * [#386][]: Add filtering helpers to zaptest's observing logger.
120 Thanks to @moitias for contributing to this release.
122 ## v1.0.0 (14 Mar 2017)
124 This is zap's first stable release. All exported APIs are now final, and no
125 further breaking changes will be made in the 1.x release series. Anyone using a
126 semver-aware dependency manager should now pin to `^1`.
130 * [#366][]: Add byte-oriented APIs to encoders to log UTF-8 encoded text without
131 casting from `[]byte` to `string`.
132 * [#364][]: To support buffering outputs, add `Sync` methods to `zapcore.Core`,
133 `zap.Logger`, and `zap.SugaredLogger`.
134 * [#371][]: Rename the `testutils` package to `zaptest`, which is less likely to
135 clash with other testing helpers.
139 * [#362][]: Make the ISO8601 time formatters fixed-width, which is friendlier
140 for tab-separated console output.
141 * [#369][]: Remove the automatic locks in `zapcore.NewCore`, which allows zap to
142 work with concurrency-safe `WriteSyncer` implementations.
143 * [#347][]: Stop reporting errors when trying to `fsync` standard out on Linux
145 * [#373][]: Report the correct caller from zap's standard library
146 interoperability wrappers.
150 * [#348][]: Add a registry allowing third-party encodings to work with zap's
152 * [#327][]: Make the representation of logger callers configurable (like times,
153 levels, and durations).
154 * [#376][]: Allow third-party encoders to use their own buffer pools, which
155 removes the last performance advantage that zap's encoders have over plugins.
156 * [#346][]: Add `CombineWriteSyncers`, a convenience function to tee multiple
157 `WriteSyncer`s and lock the result.
158 * [#365][]: Make zap's stacktraces compatible with mid-stack inlining (coming in
160 * [#372][]: Export zap's observing logger as `zaptest/observer`. This makes it
161 easier for particularly punctilious users to unit test their application's
164 Thanks to @suyash, @htrendev, @flisky, @Ulexus, and @skipor for their
165 contributions to this release.
167 ## v1.0.0-rc.3 (7 Mar 2017)
169 This is the third release candidate for zap's stable release. There are no
174 * [#339][]: Byte slices passed to `zap.Any` are now correctly treated as binary blobs
175 rather than `[]uint8`.
179 * [#307][]: Users can opt into colored output for log levels.
180 * [#353][]: In addition to hijacking the output of the standard library's
181 package-global logging functions, users can now construct a zap-backed
182 `log.Logger` instance.
183 * [#311][]: Frames from common runtime functions and some of zap's internal
184 machinery are now omitted from stacktraces.
186 Thanks to @ansel1 and @suyash for their contributions to this release.
188 ## v1.0.0-rc.2 (21 Feb 2017)
190 This is the second release candidate for zap's stable release. It includes two
195 * [#316][]: Zap's global loggers are now fully concurrency-safe
196 (previously, users had to ensure that `ReplaceGlobals` was called before the
197 loggers were in use). However, they must now be accessed via the `L()` and
198 `S()` functions. Users can update their projects with
201 gofmt -r "zap.L -> zap.L()" -w .
202 gofmt -r "zap.S -> zap.S()" -w .
204 * [#309][] and [#317][]: RC1 was mistakenly shipped with invalid
205 JSON and YAML struct tags on all config structs. This release fixes the tags
206 and adds static analysis to prevent similar bugs in the future.
210 * [#321][]: Redirecting the standard library's `log` output now
211 correctly reports the logger's caller.
215 * [#325][] and [#333][]: Zap now transparently supports non-standard, rich
216 errors like those produced by `github.com/pkg/errors`.
217 * [#326][]: Though `New(nil)` continues to return a no-op logger, `NewNop()` is
218 now preferred. Users can update their projects with `gofmt -r 'zap.New(nil) ->
220 * [#300][]: Incorrectly importing zap as `github.com/uber-go/zap` now returns a
221 more informative error.
223 Thanks to @skipor and @chapsuk for their contributions to this release.
225 ## v1.0.0-rc.1 (14 Feb 2017)
227 This is the first release candidate for zap's stable release. There are multiple
228 breaking changes and improvements from the pre-release version. Most notably:
230 * **Zap's import path is now "go.uber.org/zap"** — all users will
231 need to update their code.
232 * User-facing types and functions remain in the `zap` package. Code relevant
233 largely to extension authors is now in the `zapcore` package.
234 * The `zapcore.Core` type makes it easy for third-party packages to use zap's
235 internals but provide a different user-facing API.
236 * `Logger` is now a concrete type instead of an interface.
237 * A less verbose (though slower) logging API is included by default.
238 * Package-global loggers `L` and `S` are included.
239 * A human-friendly console encoder is included.
240 * A declarative config struct allows common logger configurations to be managed
241 as configuration instead of code.
242 * Sampling is more accurate, and doesn't depend on the standard library's shared
245 ## v0.1.0-beta.1 (6 Feb 2017)
247 This is a minor version, tagged to allow users to pin to the pre-1.0 APIs and
248 upgrade at their leisure. Since this is the first tagged release, there are no
249 backward compatibility concerns and all functionality is new.
251 Early zap adopters should pin to the 0.1.x minor version until they're ready to
252 upgrade to the upcoming stable release.
254 [#316]: https://github.com/uber-go/zap/pull/316
255 [#309]: https://github.com/uber-go/zap/pull/309
256 [#317]: https://github.com/uber-go/zap/pull/317
257 [#321]: https://github.com/uber-go/zap/pull/321
258 [#325]: https://github.com/uber-go/zap/pull/325
259 [#333]: https://github.com/uber-go/zap/pull/333
260 [#326]: https://github.com/uber-go/zap/pull/326
261 [#300]: https://github.com/uber-go/zap/pull/300
262 [#339]: https://github.com/uber-go/zap/pull/339
263 [#307]: https://github.com/uber-go/zap/pull/307
264 [#353]: https://github.com/uber-go/zap/pull/353
265 [#311]: https://github.com/uber-go/zap/pull/311
266 [#366]: https://github.com/uber-go/zap/pull/366
267 [#364]: https://github.com/uber-go/zap/pull/364
268 [#371]: https://github.com/uber-go/zap/pull/371
269 [#362]: https://github.com/uber-go/zap/pull/362
270 [#369]: https://github.com/uber-go/zap/pull/369
271 [#347]: https://github.com/uber-go/zap/pull/347
272 [#373]: https://github.com/uber-go/zap/pull/373
273 [#348]: https://github.com/uber-go/zap/pull/348
274 [#327]: https://github.com/uber-go/zap/pull/327
275 [#376]: https://github.com/uber-go/zap/pull/376
276 [#346]: https://github.com/uber-go/zap/pull/346
277 [#365]: https://github.com/uber-go/zap/pull/365
278 [#372]: https://github.com/uber-go/zap/pull/372
279 [#385]: https://github.com/uber-go/zap/pull/385
280 [#396]: https://github.com/uber-go/zap/pull/396
281 [#386]: https://github.com/uber-go/zap/pull/386
282 [#402]: https://github.com/uber-go/zap/pull/402
283 [#415]: https://github.com/uber-go/zap/pull/415
284 [#416]: https://github.com/uber-go/zap/pull/416
285 [#424]: https://github.com/uber-go/zap/pull/424
286 [#425]: https://github.com/uber-go/zap/pull/425
287 [#431]: https://github.com/uber-go/zap/pull/431
288 [#435]: https://github.com/uber-go/zap/pull/435
289 [#444]: https://github.com/uber-go/zap/pull/444
290 [#477]: https://github.com/uber-go/zap/pull/477
291 [#465]: https://github.com/uber-go/zap/pull/465
292 [#460]: https://github.com/uber-go/zap/pull/460
293 [#470]: https://github.com/uber-go/zap/pull/470
294 [#487]: https://github.com/uber-go/zap/pull/487
295 [#490]: https://github.com/uber-go/zap/pull/490
296 [#491]: https://github.com/uber-go/zap/pull/491
297 [#504]: https://github.com/uber-go/zap/pull/504
298 [#508]: https://github.com/uber-go/zap/pull/508
299 [#518]: https://github.com/uber-go/zap/pull/518
300 [#577]: https://github.com/uber-go/zap/pull/577
301 [#574]: https://github.com/uber-go/zap/pull/574
302 [#602]: https://github.com/uber-go/zap/pull/602
303 [#572]: https://github.com/uber-go/zap/pull/572
304 [#606]: https://github.com/uber-go/zap/pull/606
305 [#614]: https://github.com/uber-go/zap/pull/614