toucan2.log — io.github.camsaul/toucan2 1.0.521

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.

*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.

*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.

debugf clj macro

(debugf #{:execute :compile :results} e? msg)

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

Most log messages should be this level.

errorf clj macro

(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.

infof clj macro

(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.

level clj

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.

topics clj

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.

tracef clj macro

(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.

warnf clj macro

(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.