Duct Reitit Router

A router Duct framework that uses Reitit. This library is also compatible with Integrant.

Installation

Add the following dependency to your deps.edn file:

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

Or to your Leiningen project file:

[org.duct-framework/router.reitit "0.4.0"]

Usage

Add the :duct.router/reitit key to your Duct (or Integrant) configuration:

{:duct.router/reitit
 {:routes ["/" {:get #ig/ref :example.handler/root}]}
 :example.handler/root {}}

Once initiated the :duct.router/reitit key will produce a Ring handler.

There are four top level options available:

• :routes - the Reitit routing data
• :middleware - a vector of middleware to apply to the Ring handler
• :module-middleware - the same as above, but designed for modules
• :data - data to add to every Reitit route
• :handlers - a vector of handlers to fall back

The :data key takes a map and acts as it does in Reitit, except for the following keys:

• :muuntaja - a map of Muuntaja options to be merged with the defaults
• :coercion - one of: :malli, :schema or :spec
• :module-middleware - a vector of middleware applied only if the route matches

The :module-middleware keys work the same as the :middleware key but are applied last, as the outermost middleware. They are intended to allow a base set of middleware to be applied by modules, without interfering with middleware that is set by users.

The :duct.handler.reitit/default key will initiate into a handler using the Reitit create-default-handler function. It takes the following options:

• :not-found - a handler for 404 HTTP errors
• :method-not-allowed - a handler for 405 HTTP errors
• :not-acceptable - a handler for 406 HTTP errors

This can be referenced in the :handlers vector to provide a default handler:

{:duct.router/reitit
 {:routes   ["/" {:get #ig/ref :example.handler/root}]
  :handlers [#ig/ref :duct.handler.reitit/default]}
 :duct.handler.reitit/default {}
 :example.handler/root {}}

License

Copyright © 2025 James Reeves

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