See `example-config` for info.

General-purpose dynamic logging context. Context will be included in appender
data map at logging time.

Used for rate limiters, some appenders (e.g. Carmine), etc.
Goal: (hash data-1) = (hash data-2) iff data-1 "the same" as data-2 for
rate-limiting purposes, etc.

Default (fn [data]) -> string output fn.
You can modify default options with `(partial default-output-fn <opts-map>)`.

Controls (:timestamp_ data)

Example (+default) Timbre v4 config map.

APPENDERS
  An appender is a map with keys:
    :min-level       ; Level keyword, or nil (=> no minimum level)
    :enabled?        ;
    :async?          ; Dispatch using agent? Useful for slow appenders
    :rate-limit      ; [[ncalls-limit window-ms] <...>], or nil
    :output-fn       ; Optional override for inherited (fn [data]) -> string
    :fn              ; (fn [data]) -> side effects, with keys described below

  An appender's fn takes a single data map with keys:
    :config          ; Entire config map (this map, etc.)
    :appender-id     ; Id of appender currently dispatching
    :appender        ; Entire map of appender currently dispatching

    :instant         ; Platform date (java.util.Date or js/Date)
    :level           ; Keyword
    :error-level?    ; Is level e/o #{:error :fatal}?
    :?ns-str         ; String, or nil
    :?file           ; String, or nil  ; Waiting on CLJ-865
    :?line           ; Integer, or nil ; Waiting on CLJ-865

    :?err_           ; Delay - first-arg platform error, or nil
    :vargs_          ; Delay - raw args vector
    :hostname_       ; Delay - string (clj only)
    :msg_            ; Delay - args string
    :timestamp_      ; Delay - string
    :output-fn       ; (fn [data]) -> formatted output string
                     ; (see `default-output-fn` for details)

    :context         ; *context* value at log time (see `with-context`)
    :profile-stats   ; From `profile` macro

MIDDLEWARE
  Middleware are simple (fn [data]) -> ?data fns (applied left->right) that
  transform the data map dispatched to appender fns. If any middleware returns
  nil, NO dispatching will occur (i.e. the event will be filtered).

The `example-config` source code contains further settings and details.
See also `set-config!`, `merge-config!`, `set-level!`.

Sets JVM-global DefaultUncaughtExceptionHandler.

Logs named &env value.
Defaults to :debug logging level and "&env" as name.

Core fn-level logger. Implementation detail!

Core macro-level logger. Implementation detail!

Would Timbre currently log at the given logging level?
* Compile-time `?ns-str` arg required to support ns filtering.
* `config` arg required to support non-global config.

Returns a simple `println` appender for Clojure/Script.
Use with ClojureScript requires that `cljs.core/*print-fn*` be set.

:stream (clj only) - e/o #{:auto :*out* :*err* :std-err :std-out <io-stream>}.

Shorthand for:
(require '[taoensso.timbre :as timbre
           :refer (log  trace  debug  info  warn  error  fatal  report
                   logf tracef debugf infof warnf errorf fatalf reportf
                   spy get-env log-env)])
(require '[taoensso.timbre.profiling :as profiling
           :refer (pspy pspy* profile defnp p p*)])

Handy for sampled logging, etc.

Returns a simple `spit` file appender for Clojure.

Evaluates named expression and logs its result. Always returns the result.
Defaults to :debug logging level and unevaluated expression as name.