Asset Packager

Given a HTML file (local or remote), asset packager will download all assets (images, stylesheets, scripts) to a local folder, and rewrite the HTML file to point to the local files. The result can be easily copied onto a USB stick and used off-line.

Asset Packager is part of Slippery, a tool for creating presentations with Markdown, but can also be used stand-alone.

asset_packer file.html target.html
asset_packer http://example.org/file.html target.html

This will create target.html, and a directory target_assets containing all the assets.

Asset Packager is at its core a Hexp transformation, it transform one HTML DOM tree into another. While doing so it creates some files. To use it directly on a Hexp document you need to pass it a bit of extra information

• the source URI, needed to resolve relative URI's
• the asset directory, where assets will be stored. Will be created if it doesn't exist
• the destination HTML file name, used to calculate new relative URI's for the assets

doc = Hexp.parse(...)
doc = AssetPacker::Processor::Local.new('http://foo/bar', '/tmp/assets', '/tmp/result.html').call(doc)
File.write('/tmp/result.html', doc.to_html)

So far, the following assets are recognized

• img[src]
• link[rel="stylesheet"][href]
• script[src]

Asset Packager has 100% mutation coverage using Mutant. It is a rewrite of functionality originally included in Slippery, used to demonstrate the concept of mutation testing for an article for Sitepoint.

Use a feature branch, make sure rake mutant tells you all is fine, then send a pull request.

Copyright 2014 Arne Brasseur

Available under the MIT license, see LICENSE file for details.