Liking cljdoc? Tell your friends :D

toucan2.log

Toucan 2 logging utilities. This is basically just a fancy wrapper around clojure.tools.logging that supports some additional debugging facilities, such as dynamically enabling logging for different topics or levels from the REPL.

Toucan 2 logging utilities. This is basically just a fancy wrapper around `clojure.tools.logging` that supports some
additional debugging facilities, such as dynamically enabling logging for different topics or levels from the REPL.
raw docstring

*level*clj

The current log level (as a keyword) to log messages directly to stdout with. By default this is nil, which means don't log any messages to stdout regardless of their level. (They are still logged via clojure.tools.logging.)

You can dynamically bind this to enable logging at a higher level in the REPL for debugging purposes. You can also set a default value for this by setting the atom level.

The current log level (as a keyword) to log messages directly to stdout with. By default this is `nil`, which means
don't log any messages to stdout regardless of their level. (They are still logged via `clojure.tools.logging`.)

You can dynamically bind this to enable logging at a higher level in the REPL for debugging purposes. You can also set
a default value for this by setting the atom [[level]].
sourceraw docstring

*topics*clj

The set of topics to log directly to stdout, if the *level* is high enough. By default, this is nil, which means log all topics. You can specify default topics by setting the atom topics.

The set of topics to log directly to stdout, if the [[*level*]] is high enough. By default, this is `nil`, which means
log *all* topics. You can specify default topics by setting the atom [[topics]].
sourceraw docstring

debugfcljmacro

(debugf #{:execute :compile :results} e? msg)
(debugf #{:execute :compile :results} e? format-string & args)

Most log messages should be this level.

Most log messages should be this level.
sourceraw docstring

errorfcljmacro

(errorf #{:execute :compile :results} e? msg)
(errorf #{:execute :compile :results} e? format-string & args)

Log an error message for a topic. Optionally include a throwable. Only things that are actually serious errors should be logged at this level.

Log an error message for a `topic`. Optionally include a `throwable`. Only things that are actually serious errors
should be logged at this level.
sourceraw docstring

infofcljmacro

(infof #{:execute :compile :results} e? msg)
(infof #{:execute :compile :results} e? format-string & args)

Only things that all users should see by default without configuring a logger should be this level.

Only things that all users should see by default without configuring a logger should be this level.
sourceraw docstring

levelclj

The default log level to log messages directly to stdout with. Takes the value of the env var TOUCAN_DEBUG_LEVEL, if set. Can be overridden with *level*. This is stored as an atom, so you can swap! or reset! it.

The default log level to log messages directly to stdout with. Takes the value of the env var
`TOUCAN_DEBUG_LEVEL`, if set. Can be overridden with [[*level*]]. This is stored as an atom, so you can `swap!` or
`reset!` it.
sourceraw docstring

topicsclj

Default topics to log directly to stdout, if the level is high enough. This can be set with a comma-separated list with the env var TOUCAN_DEBUG_TOPICS. It is an atom, so you can also swap! or reset! it at runtime.

Default *topics* to log directly to stdout, if the level is high enough. This can be set with a
comma-separated list with the env var `TOUCAN_DEBUG_TOPICS`. It is an atom, so you can also `swap!` or `reset!` it at
runtime.
sourceraw docstring

tracefcljmacro

(tracef #{:execute :compile :results} e? msg)
(tracef #{:execute :compile :results} e? format-string & args)

Log messages that are done once-per-row should be this level.

Log messages that are done once-per-row should be this level.
sourceraw docstring

warnfcljmacro

(warnf #{:execute :compile :results} e? msg)
(warnf #{:execute :compile :results} e? format-string & args)

Log a warning for a topic. Optionally include a throwable. Bad things that can be worked around should be logged at this level.

Log a warning for a `topic`. Optionally include a `throwable`. Bad things that can be worked around should be logged at
this level.
sourceraw docstring

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close