Ash Ra Template

Expressive & customizable template system featuring Clojure language processing

Tested with Clojure 1.10.0 and newer, and with Java 8 and newer LTS releases.

Components

ART library, the renderer proper. Includes detailed information about using the ART library and ART template syntax, rendering API and options, and processing.

ART CLI library aggregates code common to the interpretation and processing of ART build tool and command line arguments.

Clojure tool for rendering ART templates.

Leiningen plugin for rendering ART templates.

Quick Start

Include this library from Clojars by adding the latest version of net.vivid-inc/art to your project dependencies:

{:deps {net.vivid-inc/art {:mvn/version "0.7.0"}}}         ; Clojure tools deps.edn
:dependencies [[net.vivid-inc/art "0.7.0"]]                ; Leiningen project.clj

Render a template string:

(require '[vivid.art :as art])

(art/render "There were <(= (+ 1 2) )> swallows, dancing in the sky.")

Or, to render from a file:

(art/render (slurp "index.html.art"))

Use cases

• Automating the bulk generation of data files, such as SQL unit tests in data science, per-language I18n/M10n files.
• HTTP server templating engine, dynamic web content.
• Static website generation (SSG), including HTML pages, blog articles, navigation, layouts, headers and footers, templated SVG images.
• Templating source code files, for example to encode project meta-data as variables written in a source file.

Contributing

Pull Requests are welcome! We work with people offering PRs to revise and iterate leading to solutions in accord with project goals and release criteria. Development topics and product roadmap are maininted in DEVELOP.md. Commits must include Signed-off-by indicating acceptance of the Developer's Certificate of Origin. Unproductive behavior such as unkindness towards others and derailment is not tolerated.

Attributions

• Original implementation by Vivid Inc.
• Illustration by Ruxandra.

Of the Clojure templating libraries we identified, none seemed to assist in porting a non-trivial amount of ERB-templated content to a Clojure-based static site generation tool. We find the ability to in-line arbitrary Clojure code is intoxicatingly pragmatic (also expressed as: Enough rope to hang oneself). Seeking to wield such expressive power in a general-purpose templating system, we wrote Ash Ra Template, or ART.

License

© Copyright Vivid Inc. Apache License 2.0 licensed.