jolt/docs/libraries.md

Clojure libraries known to work with Jolt

Libraries confirmed to load and pass their conformance checks on Jolt (see the examples, e.g. the ring-app example).

• aero — EDN configuration with tag literals; read-config resolves #ref/#env/#or/#profile/#long/… and map/vector/set configs round-trip
• config
• Selmer
• medley
• cuerdas
• ring-core — via :deps/root "ring-core", on the ring-app example's spork/http adapter
• ring-codec
• reitit-core — data-driven routing; the reitit.Trie Java class is mirrored in Clojure by jolt-lang/router. Load with JOLT_FEATURES including clj.
• integrant — data-driven system configuration; ig/init/ig/halt! build and tear down a component graph wired with #ig/ref, on the ring-app example. Loads unmodified with its dependency and meta-merge deps.
• honeysql — full formatter + helpers (select/insert/update/delete/joins/:inline), loaded unmodified from git
• clojure.jdbc — as jolt-lang/db's jdbc.core, over the built-in SQLite access (libsqlite3 via Chez's FFI)
• next.jdbc — a compatibility layer in jolt-lang/db (next.jdbc, next.jdbc.sql, next.jdbc.prepare, next.jdbc.transaction) over jdbc.core, for libraries that target the next.jdbc API
• tools.logging — the real clojure.tools.logging source runs verbatim. jolt provides a native clojure.tools.logging.impl backend (a stderr LoggerFactory — the library's designed extension point, where slf4j/log4j/jul adapters normally plug in) plus the host shims it needs (agent/send-off, clojure.lang.LockingTransaction, a clojure.pprint subset, clojure.string/trim-newline). The level macros, logf/logp, spy, and enabled? all work; output goes to stderr.
• migratus — database migrations; loads unmodified and runs filesystem SQL/EDN migrations against SQLite through the next.jdbc layer above. migrate/rollback round-trip end to end.
• malli — data schema validation, on the malli-app example. m/validate and m/explain work across the vocabulary (predicates, :int/ :string/:keyword, :map incl. nested + optional, :vector, :tuple, :enum, :maybe, :and/:or, :re, bounded int/string). Load with JOLT_FEATURES including clj (malli's .cljc keys class-schemas off the :clj reader-conditional branches).
• markdown-clj — Markdown → HTML, on the markdown-app example. Renders headings, emphasis, inline code, links, lists, tables, strikethrough.
• hiccup — HTML from Clojure data, on the hiccup-app example. Element tags, attribute maps, nested elements, and for comprehensions; its html macro pre-compiles the markup (a good compiler stress test).
• clojure.data.json — JSON reading and writing; read-str/write-str with key/value fns and options. Its own test suite passes 138/139.
• clojure.spec.alpha — data specs; s/def, s/valid?, s/conform, s/cat/s/keys, s/explain-str, and s/check-asserts work over the registry.
• tick — date/time over Jolt's java.time. Its api and alpha.interval test suites pass in full, including named-zone DST, nanosecond instants, and French locale formatting. Loads with JOLT_FEATURES including clj; #time/… literals work via time-literals' data readers.
• core.match — pattern matching. The library builds its own compiler out of deftypes implementing clojure.lang interfaces; its test suite passes 111/115 (literal/vector/map/seq/guard/or/rest/ bind patterns, :only, :guard). Regex-literal and primitive-array patterns aren't supported yet.