A deprecated Ring middleware to serve concatenated static files with cache buster URLs in production.
Clojure JavaScript CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src/catenate
test
.gitignore
.travis.yml
README.md
concatenated.jpg
instructions.md
project.clj

README.md

catenate

Catenate is deprecated in favor of optimus.

Why?

I had planned on catenate being a small library in a series of libraries for frontend optimization. Catenate was the one that concatenated your static assets into bundles.

Turns out that a lot of those optimizations you want to do on the frontend are tangled together. I was not able to do those improvements I wanted with this model.

So, when the API turned out quite different, I figured it would be better with a name that isn't so focused on concatenation - and more on optimization: optimus.

I do miss the concatenated cats tho:

I'm still using catenate, where are the docs?

You can find them in instructions.md.

How do I migrate to optimus?

This is catenate:

(-> app
    (catenate/wrap
     :bundles my-bundles
     :extra-files my-files
     :debug (:debug env)
     :public-dir "public"))

This is optimus:

(defn get-assets []
  (concat
   (assets/load-bundles "public" my-bundles)
   (assets/load-assets "public" my-files)))

(-> app
    (optimus/wrap
     get-assets
     (if (:debug env)
       strategies/serve-unchanged-assets
       strategies/serve-frozen-optimized-assets)))

There's more code here, and less configuration. In other words, more power to you.

What do I get if I upgrade?

At the time of writing, there's this:

  • You can change your get-assets function in development-mode, and see those changes mirrored without a restart.

  • You can list files to include in bundles using regexp.

  • You get minification of scripts and styles.

  • You can serve optimized assets while developing, so that you are in a production-like environment, but with live reloads.