Duct Logger

A logging library for the Duct framework.

Installation

Add the following dependency to your deps.edn file:

org.duct-framework/logger {:mvn/version "0.4.0"}

Or to your Leiningen project file:

[org.duct-framework/logger "0.4.0"]

Usage

To use this library, you'll need an implementation of the duct.logger/Logger protocol. You can implement this yourself, or use a pre-written one, such as [logger.simple][].

Once you have a logger, you can use the duct.logger/log macro. Logging in Duct is data-driven, and has three parts:

1. The logging level
2. A namespaced keyword that represents the event occurring
3. A map of relevant event data

For example, instead of writing something like this:

(log/info "Starting server on port" port)

We instead write something like:

(log/log logger :info ::starting-server {:port port})

The use of keywords and data structures produces logs that can be queried more efficiently and consistantly than logs written in English.

This library also provides convenience macros for the following logging levels: report, fatal, error, warn info and debug. This allows logs to be written:

(log/info logger ::starting-server {:port port})

If the logger is nil, no logs are outputted. If the logger is a collection of loggers, then each element of the collection will be sent the log.

Documentation

• API Docs

License

Copyright © 2024 James Reeves

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.