ch.codesmith.logger — ch.codesmith/logger 0.6.89

aggregate-markers clj

(aggregate-markers args)

assoc clj

(assoc {:keys [m]} k v)

(assoc {:keys [m]} k v & kvs)

Assoc the given key/values a prerendered context.

box clj macro

(box arg)

Ensures at compile time that the argument is an Object. This macro is necessary to avoid reflection warning from numeric constants that are emitted unboxed by the compiler.

coerce-string clj macro

(coerce-string arg)

Coerce, at compile time, the argument to be a String.

compile-to-array clj macro

(compile-to-array & args)

Compile code to create a java array with the given arguments

compile-to-struct-args clj macro

(compile-to-struct-args & args)

Compile code to create a java array with the given arguments

Context clj

context-logging-key clj

The key under which the log-c, log-m and log-e macros put the context in the logstash JSON. By default, it is "context".

context-pre-logging-transformation clj

A transformation function that is applied to the context before logging. By default, it is the identity (no transformation).

ctx clj

(ctx m)

Wraps the supplied map in a record containing a prerendered Marker; this allows to use a relatively static context without rerendering it as json on every log entry.

debug-c clj macro

(debug-c ctx)

(debug-c ctx msg)

(debug-c ctx msg & struct-args)

Uses log-c on debug level.

debug-e clj macro

(debug-e e)

(debug-e e ctx)

(debug-e e ctx msg)

Uses log-e on debug level.

debug-m clj macro

(debug-m msg & args)

Uses log-m on debug level.

debug-s clj macro

(debug-s msg & struct-args)

Uses log-s on trace debug.

default-context-logging-key clj

default-context-pre-logging-transformation clj

default-ex-data-logging-key clj

default-version-file-path clj

deflogger clj macro

(deflogger)

Creates a var named ⠇⠕⠶⠻ in the current namespace *ns* to contain a [[org.slf4j.Logger]] The name is "logger" written in braille-2 notation.

ensure-throwable clj

(ensure-throwable e)

Ensures, at runtime, that the argument is a throwable. If the argument is not throwable, its string representation is embedded in an ex-info.

error-c clj macro

(error-c ctx)

(error-c ctx msg)

(error-c ctx msg & args)

Uses log-c on error level.

error-e clj macro

(error-e e)

(error-e e ctx)

(error-e e ctx msg)

Uses log-e on error level.

error-m clj macro

(error-m msg & args)

Uses log-m on error level.

error-s clj macro

(error-s msg & struct-args)

Uses log-s on trace error.

ex-data-logging-key clj

The key under with the log-e macros put the ex-data from an exception in the logstash JSON. By default, it is "exdata".

fullname clj

(fullname k)

info-c clj macro

(info-c ctx)

(info-c ctx msg)

(info-c ctx msg & args)

Uses log-c on info level.

info-e clj macro

(info-e e)

(info-e e ctx)

(info-e e ctx msg)

Uses log-e on info level.

info-m clj macro

(info-m msg & args)

Uses log-m on info level.

info-s clj macro

(info-s msg & struct-args)

Uses log-s on trace info.

kv clj

(kv k v)

level-pred clj

(level-pred method)

For the given method symbol, compute the corresponding isXXXEnabled method symbol.

log-c clj macro

(log-c method ctx)

(log-c method ctx msg)

(log-c method ctx msg & struct-args)

Logging macro to output the context map ctx in the JSON string generated by the logstash encoder. Variants allow to pass a message as slf4j format string with 2*n structured arguments. The argument method is the symbol of the log method to call on the [[Logger]] object. Typically, the level macros (trace-c, debug-c, etc.) are used instead of this macro. The macro generates code that verifies that the corresponding log level is enabled.

log-e clj macro

(log-e method e)

(log-e method e ctx)

(log-e method e ctx msg)

Logging macro for logging a [[Throwable]] using the dedicated logging methods for errors. Variants allow to pass a context ctx and an explicit message msg. If no msg is provided, the message of the [[Throwable]] is use instead. If ex-data of the exception is defined, it is included as a Marker under the key ex-data-logging-key. The argument method is the symbol of the log method to call on the [[Logger]] object. Typically, the level macros (trace-e, debug-e, etc.) are used instead of this macro. The macro generates code that verifies that the corresponding log level is enabled.

log-m clj macro

(log-m method msg & args)

Logging macro for a simple logging message msg. Variants allow to pass a message as slf4j format string with n arguments. The argument method is the symbol of the log method to call on the [[Logger]] object. Typically, the level macros (trace-m, debug-m, etc.) are used instead of this macro.

log-s clj macro

(log-s method msg & struct-args)

Logging macro for a logging message msg with structured arguments Variants allow to pass a message as slf4j format string with 2*n structured arguments. The argument method is the symbol of the log method to call on the [[Logger]] object. Typically, the level macros (trace-s, `debug-s, etc.) are used instead of this macro. The macro generates code that verifies that the corresponding log level is enabled.

raw-json clj

(raw-json value)

set-context-logging-key! clj

(set-context-logging-key! logging-key)

Configuration function to set the context-logging-key.

set-context-pre-logging-transformation! clj

(set-context-pre-logging-transformation! tranformation)

Configuration function to set the context-pre-logging-transformation

set-ex-data-logging-key! clj

(set-ex-data-logging-key! logging-key)

Configuration function to set the ex-data-logging-key.

set-version-file-path! clj

(set-version-file-path! path)

Configuration function to set the version-file-path

spy clj macro

(spy expr)

(spy level expr)

A spy macro to log inspection of an expression. It will log the value of the expression and the expression itself as context via log-c with "spy" as message. By default, it uses the debug level; the diadic version allows to specify the level as string, keyword or symbol (e.g. `(spy :info (+ 1 2)) for info level.

throw-logger-missing-exception clj

(throw-logger-missing-exception)

Throw an [[IllegalStateException]] to signal that the deflogger macro has not been called properly.

ToContextMarker clj protocol

ctx-marker clj

(ctx-marker self)

marker clj

(marker self logging-key)

trace-c clj macro

(trace-c ctx)

(trace-c ctx msg)

(trace-c ctx msg & struct-args)

Uses loc-c on trace level.

trace-e clj macro

(trace-e e)

(trace-e e ctx)

(trace-e e ctx msg)

Uses log-e on trace level.

trace-m clj macro

(trace-m msg & args)

Uses loc-m on trace level.

trace-s clj macro

(trace-s msg & struct-args)

Uses log-s on trace level.

version clj macro

(version)

(version ns)

version-file-path clj

A path (as string) where a edn file with the version of the program is located. The edn file must be a map with the key :version. By default, it is the location where the anvil library creates a version edn file when building docker artifacts.

version-from-file clj

(version-from-file)

(version-from-file version-file)

version-from-ns-as-class clj macro

(version-from-ns-as-class)

(version-from-ns-as-class ns)

warn-c clj macro

(warn-c ctx)

(warn-c ctx msg)

(warn-c ctx msg & args)

Uses log-c on warn level.

warn-e clj macro

(warn-e e)

(warn-e e ctx)

(warn-e e ctx msg)

Uses log-e on warn level.

warn-m clj macro

(warn-m msg & args)

Uses log-m on warn level.

warn-s clj macro

(warn-s msg & struct-args)

Uses log-s on trace warn.

⠇⠕⠶⠻ clj