View on GitHub

node hashcat

Download this project as a .zip file Download this project as a tar.gz file

hashcat

A commandline utility to concatenate, minify and cache-bust your Javascript references in HTML.

It works by parsing the HTML file for special markup. It then concatenates, minifies, hashes and replaces references to those files. It is ideal for use with a build tool as part of your CI pipeline.

Install

npm install -g hashcat

Usage

Prepare your references by surrounding them with special comment blocks.

<!-- #cat app-min.js -->
<script src="1.js" />
<script type="text/javascript" src="other-folder/3.js"></script>
<!-- endcat -->

Pass the HTML file to hashcat

hashcat app/index.html

After processing, the above reference should be replaced with something like this:

<script src="d41d8cd9.app-min.js"></script>

How

The two Javascript files are concatenated and minified into a single file. A hash of the resulting file's contents is then taken and the first 8 characters are prepended to the file's name. Finally, the reference blocks in the HTML are replaced with this new file.

The concatenation and minification allow for multiple files during development but a smaller, simpler asset in production.

The hash rename provides cache busting by changing the file name on each deployment if the contents have changed.

About

This tool is similar to the grunt-usemin task. Currently, it uses some of the processing code but only processes Javascript references.

In our case, using grunt as part of a CI pipeline meant having to run npm install hundreds of times a day which was not desirable. A standalone tool solves this specific problem by reducing the external dependencies and does not leave the build agent in a transient state.