status-im
/
timbre
mirror of https://github.com/status-im/timbre.git
2
0
Fork 0
Code Issues Projects Releases Wiki Activity

v4.0.0-beta4 (== v4.0.0-beta3; Clojars upload failed, broke asset)

This commit is contained in:
Peter Taoussanis 2015-05-28 13:06:13 +07:00
parent 142a2d9d08
commit e5f3e6596f
3 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
CHANGELOG.md
View File

@ -1,6 +1,6 @@
> This project uses [Break Versioning](https://github.com/ptaoussanis/encore/blob/master/BREAK-VERSIONING.md) as of **Aug 16, 2014**.
## v4.0.0-beta2 / 2015 May 26
## v4.0.0-beta4 / 2015 May 28
> This is a **MAJOR** update. Your custom appenders **WILL BREAK**. Your configuration **MIGHT BREAK**. Your call sites should be fine. I've updated all bundled appenders, but **haven't tested** any 3rd-party appenders.
@ -10,14 +10,14 @@
* **New**: default :println appender has picked up a :stream opt [#49]
* **New**: create necessary spit appender paths [#93]
* **New**: full-power fn-level `log1-fn` util [#99]
* **New**: added a reference appender example [here](https://github.com/ptaoussanis/timbre/blob/master/src/taoensso/timbre/appenders/example_appender.clj)
* **New**: added a reference appender example [here](https://github.com/ptaoussanis/timbre/blob/master/src/taoensso/timbre/appenders/core.cljx)
* **Implementation**: modernized + simplified codebase
* **Implementation**: significant performance improvements across the board
* **Implementation**: use delays to avoid unnecessarily producing unused arg msgs [#71]
* **Fix**: auto shutdown agents to prevent slow app shutdown [#61]
```clojure
[com.taoensso/timbre "4.0.0-beta2"]
[com.taoensso/timbre "4.0.0-beta4"]
```
### Migration checklist
@ -32,9 +32,10 @@
* Renamed appender args: `:ns`->`:?ns-str`, `:file`->`:?file`, `:line`->`:?line`
* Appender args now wrapped with delays: `:throwable`->`:?err_`, `:message`->`:msg_`, `:timestamp`->`:timestamp_`, `:hostname`->`:hostname_`, `:args`->`:vargs_`
* Appender args removed: `:output`, `:ap-config`
* Appender args added: `:output-fn (fn [data]) -> string`, `:appender-opts`
* Appender args added: `:output-fn (fn [data]) -> string`
* `stacktrace` util fn signature changed: `[throwable & [sep fonts]` -> `[err & [opts]]`
* All bundled 3rd-party appenders have moved to a new `3rd-party` ns
* All bundled 3rd-party appenders have moved to a new `3rd-party` ns.
* Bundled 3rd-party appender constructor signatures _may_ have changed, please double check.
Apologies for the hassle in migrating. The changes made here all bring serious benefits (performance, simplicity, future extensibility, cross-platform support) and I'm confident that v4's the last time I'll need to touch the core design. Future work will be focused on polish, stability, and better+more bundled appenders.

6
README.md
View File

@ -2,7 +2,7 @@
```clojure
[com.taoensso/timbre "3.4.0"] ; Stable
[com.taoensso/timbre "4.0.0-beta1"] ; BREAKING, please see CHANGELOG for details
[com.taoensso/timbre "4.0.0-beta4"] ; BREAKING, please see CHANGELOG for details
```
# Timbre, a (sane) Clojure/Script logging & profiling library
@ -36,7 +36,7 @@ Timbre brings functional, Clojure-y goodness to all your logging needs. It's fas
Add the necessary dependency to your [Leiningen][] `project.clj` and use the supplied ns-import helper:
```clojure
[com.taoensso/timbre "4.0.0-beta1"] ; Add to your project.clj :dependencies
[com.taoensso/timbre "4.0.0-beta4"] ; Add to your project.clj :dependencies
(ns my-app ; Your ns
(:require [taoensso.timbre :as timbre
@ -287,4 +287,4 @@ Copyright © 2012-2015 Peter Taoussanis. Distributed under the [Eclipse Publ
[Cider]: https://github.com/clojure-emacs/cider
[CDS]: http://clojure-doc.org/
[ClojureWerkz]: http://clojurewerkz.org/
[Eclipse Public License]: https://raw2.github.com/ptaoussanis/timbre/master/LICENSE
[Eclipse Public License]: https://raw2.github.com/ptaoussanis/timbre/master/LICENSE

2
project.clj
View File

@ -1,4 +1,4 @@
(defproject com.taoensso/timbre "4.0.0-beta2"
(defproject com.taoensso/timbre "4.0.0-beta4"
:author "Peter Taoussanis <https://www.taoensso.com>"
:description "Clojure/Script logging & profiling library"
:url "https://github.com/ptaoussanis/timbre"