codesmith.logger.core — codesmith/logger 0.1.0

Codesmith Logger is a simple wrapper on logback (slf4j) and net.logstash.logback. To use the library, it is necessary to call the macro deflogger before any logging macro is called.

box clj macro

(box arg)

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)

context-logging-key clj

The key under which the log-c 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-marker clj

(ctx-marker ctx)

debug-c clj macro

(debug-c ctx)

(debug-c ctx msg)

(debug-c ctx msg & args)

Uses log-c on debug level.

debug-e clj macro

(debug-e e)

(debug-e e msg)

(debug-e e ctx msg)

Uses log-e on debug level.

debug-m clj macro

(debug-m msg & args)

default-context-logging-key clj

default-context-pre-logging-transformation 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)

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 msg)

(error-e e ctx msg)

Uses log-e on error level.

error-m clj macro

(error-m msg & args)

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 msg)

(info-e e ctx msg)

Uses log-e on info level.

info-m clj macro

(info-m msg & args)

level-pred clj

(level-pred method)

log-c clj macro

(log-c method ctx)

(log-c method ctx msg)

(log-c method ctx msg & 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 n 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 msg)

(log-e method e ctx msg)

Logging macro for logging a [[Throwable]] using the dedicated logging methods for errors. Variants allow to pass an explicit message msg and an explicit context ctx. If no msg is provided, the message of the [[Throwable]] is use instead. If no context is provided, we use ex-data to obtain a context. If a context is provided, it is merged with ex-data. 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)

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

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)

trace-c clj macro

(trace-c ctx)

(trace-c ctx msg)

(trace-c ctx msg & args)

Uses loc-c on trace level.

trace-e clj macro

(trace-e e)

(trace-e e msg)

(trace-e e ctx msg)

Uses log-e on trace level.

trace-m clj macro

(trace-m msg & args)

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 msg)

(warn-e e ctx msg)

Uses log-e on warn level.

warn-m clj macro

(warn-m msg & args)

⠇⠕⠶⠻ clj