(assoc {:keys [m]} k v)
(assoc {:keys [m]} k v & kvs)
Assoc the given key/values a prerendered context.
Assoc the given key/values a prerendered context.
(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.
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 arg)
Coerce, at compile time, the argument to be a String.
Coerce, at compile time, the argument to be a String.
(compile-to-array & args)
Compile code to create a java array with the given arguments
Compile code to create a java array with the given arguments
(compile-to-struct-args & args)
Compile code to create a java array with the given arguments
Compile code to create a java array with the given arguments
A transformation function that is applied to the context before logging. By default, it is the identity (no transformation).
A transformation function that is applied to the context before logging. By default, it is the identity (no transformation).
(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.
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 ctx)
(debug-c ctx msg)
(debug-c ctx msg & struct-args)
Uses log-c
on debug level.
Uses `log-c` on debug level.
(debug-e e)
(debug-e e ctx)
(debug-e e ctx msg)
Uses log-e
on debug level.
Uses `log-e` on debug level.
(debug-m msg & args)
Uses log-m
on debug level.
Uses `log-m` on debug level.
(debug-s msg & struct-args)
Uses log-s
on trace debug.
Uses `log-s` on trace debug.
(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.
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 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
.
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 ctx)
(error-c ctx msg)
(error-c ctx msg & args)
Uses log-c
on error level.
Uses `log-c` on error level.
(error-e e)
(error-e e ctx)
(error-e e ctx msg)
Uses log-e
on error level.
Uses `log-e` on error level.
(error-m msg & args)
Uses log-m
on error level.
Uses `log-m` on error level.
(error-s msg & struct-args)
Uses log-s
on trace error.
Uses `log-s` on trace error.
The key under with the log-e
macros put the ex-data
from an exception in the logstash JSON.
By default, it is "exdata".
The key under with the [[log-e]] macros put the `ex-data` from an exception in the logstash JSON. By default, it is "exdata".
(info-c ctx)
(info-c ctx msg)
(info-c ctx msg & args)
Uses log-c
on info level.
Uses `log-c` on info level.
(info-e e)
(info-e e ctx)
(info-e e ctx msg)
Uses log-e
on info level.
Uses `log-e` on info level.
(info-m msg & args)
Uses log-m
on info level.
Uses `log-m` on info level.
(info-s msg & struct-args)
Uses log-s
on trace info.
Uses `log-s` on trace info.
The object mapper used by jsonista for the serialization in raw json of the context markers created by this library.
The object mapper used by jsonista for the serialization in raw json of the context markers created by this library.
(level-pred method)
For the given method
symbol, compute the corresponding isXXXEnabled
method symbol.
For the given `method` symbol, compute the corresponding `isXXXEnabled` method symbol.
(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.
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 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.
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 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.
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 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.
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.
(set-context-logging-key! logging-key)
Configuration function to set the context-logging-key
.
Configuration function to set the [[context-logging-key]].
(set-context-pre-logging-transformation! tranformation)
Configuration function to set the context-pre-logging-transformation
Configuration function to set the [[context-pre-logging-transformation]]
(set-ex-data-logging-key! logging-key)
Configuration function to set the ex-data-logging-key
.
Configuration function to set the [[ex-data-logging-key]].
(set-jsonista-object-mapper object-mapper)
Configuration function to ste the jsonista-object-mapper
Configuration function to ste the [[jsonista-object-mapper]]
(set-version-file-path! path)
Configuration function to set the version-file-path
Configuration function to set the [[version-file-path]]
(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.
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)
Throw an [[IllegalStateException]] to signal that the deflogger
macro has not been called properly.
Throw an [[IllegalStateException]] to signal that the `deflogger` macro has not been called properly.
(trace-c ctx)
(trace-c ctx msg)
(trace-c ctx msg & struct-args)
Uses loc-c
on trace level.
Uses `loc-c` on trace level.
(trace-e e)
(trace-e e ctx)
(trace-e e ctx msg)
Uses log-e
on trace level.
Uses `log-e` on trace level.
(trace-m msg & args)
Uses loc-m
on trace level.
Uses `loc-m` on trace level.
(trace-s msg & struct-args)
Uses log-s
on trace level.
Uses `log-s` on trace level.
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.
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](https://github.com/codesmith-gmbh/anvil) library creates a version edn file when building docker artifacts.
(warn-c ctx)
(warn-c ctx msg)
(warn-c ctx msg & args)
Uses log-c
on warn level.
Uses `log-c` on warn level.
(warn-e e)
(warn-e e ctx)
(warn-e e ctx msg)
Uses log-e
on warn level.
Uses `log-e` on warn level.
(warn-m msg & args)
Uses log-m
on warn level.
Uses `log-m` on warn level.
(warn-s msg & struct-args)
Uses log-s
on trace warn.
Uses `log-s` on trace warn.
cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close