{"_id":"asset-smasher","_rev":"45-7ad23fe6957e8ae34450c613b3746459","name":"asset-smasher","description":"Asset pre-processor, merger, and compressor.","dist-tags":{"latest":"0.3.2"},"versions":{"0.1.0":{"name":"asset-smasher","description":"Asset pre-processor, merger, and compressor.","version":"0.1.0","author":{"name":"Jim Riecken","email":"jriecken@gmail.com"},"keywords":["asset","compress","merge","preprocess"],"license":{"type":"MIT","url":"http://github.com/jriecken/asset-smasher/raw/master/LICENSE"},"repository":{"type":"git","url":"git://github.com/jriecken/asset-smasher.git"},"bugs":{"url":"http://github.com/jriecken/asset-smasher/issues"},"main":"./lib/asset-smasher.js","bin":{"asset-smasher":"./bin/asset-smasher"},"dependencies":{"async":"0.1.18","commander":"0.6.0","glob":"3.1.9","mkdirp":"0.3.2","minimatch":"0.2.4","uglify-js":"1.3.0","underscore":"1.3.3"},"optionalDependencies":{},"devDependencies":{},"engines":{"node":">= 0.6.0"},"_npmUser":{"name":"jriecken","email":"jriecken@gmail.com"},"_id":"asset-smasher@0.1.0","_engineSupported":true,"_npmVersion":"1.1.19","_nodeVersion":"v0.6.16","_defaultsLoaded":true,"dist":{"shasum":"99e5e220e8c48bc01ed2e669d4b24cf3ad0df6d2","tarball":"https://registry.npmjs.org/asset-smasher/-/asset-smasher-0.1.0.tgz","integrity":"sha512-MVY8pay6RCGkacuhwj8IHdtawKoXTkOB6kt7r25wDHFjXxKkLslojVtT7XLjGstqj8ffE7dDsR99CKz+yWX6OA==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQC3KP6v/FUbpFuFT3zFtDYwsJESroVlS3Be/rDJ45cNZQIhANswsclkyWlJTqp90a5vBfOzCbKV/h+SHJQUtdCP49lQ"}]},"maintainers":[{"name":"jriecken","email":"jriecken@gmail.com"}]},"0.1.1":{"name":"asset-smasher","description":"Asset pre-processor, merger, and compressor.","version":"0.1.1","author":{"name":"Jim Riecken","email":"jriecken@gmail.com"},"keywords":["asset","compress","merge","preprocess"],"license":{"type":"MIT","url":"http://github.com/jriecken/asset-smasher/raw/master/LICENSE"},"repository":{"type":"git","url":"git://github.com/jriecken/asset-smasher.git"},"bugs":{"url":"http://github.com/jriecken/asset-smasher/issues"},"main":"./lib/asset-smasher.js","bin":{"asset-smasher":"./bin/asset-smasher"},"dependencies":{"async":"0.1.18","commander":"0.6.0","glob":"3.1.9","mkdirp":"0.3.2","minimatch":"0.2.4","uglify-js":"1.3.0","underscore":"1.3.3"},"optionalDependencies":{},"devDependencies":{},"engines":{"node":">= 0.6.0"},"_npmUser":{"name":"jriecken","email":"jriecken@gmail.com"},"_id":"asset-smasher@0.1.1","_engineSupported":true,"_npmVersion":"1.1.19","_nodeVersion":"v0.6.16","_defaultsLoaded":true,"dist":{"shasum":"a3fa8e2f54ef4c581f1c717d55a4f1c26cb8e9ee","tarball":"https://registry.npmjs.org/asset-smasher/-/asset-smasher-0.1.1.tgz","integrity":"sha512-Mak7BD4xdDnEQui1gT1ALgKxGPWczcltPNih28AQR5baw5gSxIyaZcJK9Snqlz+Jup/eFgrIUGPbewzWU8OcTQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDkfsl4dl661lYTCuClbp8yRvMReemLjnXeopwqqRsG8gIhAMphjjjUzQXCsMceyy/CoaEHrzqqO/l+wHEx0GOxzUE4"}]},"maintainers":[{"name":"jriecken","email":"jriecken@gmail.com"}]},"0.1.2":{"name":"asset-smasher","description":"Asset pre-processor, merger, and compressor.","version":"0.1.2","author":{"name":"Jim Riecken","email":"jriecken@gmail.com"},"keywords":["asset","compress","merge","preprocess"],"license":{"type":"MIT","url":"http://github.com/jriecken/asset-smasher/raw/master/LICENSE"},"repository":{"type":"git","url":"git://github.com/jriecken/asset-smasher.git"},"bugs":{"url":"http://github.com/jriecken/asset-smasher/issues"},"main":"./lib/asset-smasher.js","bin":{"asset-smasher":"./bin/asset-smasher"},"dependencies":{"async":"0.1.22","commander":"0.6.1","glob":"3.1.10","mkdirp":"0.3.3","minimatch":"0.2.5","uglify-js":"1.3.2","underscore":"1.3.3"},"optionalDependencies":{},"devDependencies":{},"engines":{"node":">= 0.6.0"},"_npmUser":{"name":"jriecken","email":"jriecken@gmail.com"},"_id":"asset-smasher@0.1.2","_engineSupported":true,"_npmVersion":"1.1.19","_nodeVersion":"v0.6.16","_defaultsLoaded":true,"dist":{"shasum":"46805a147633524fb0249595f22f96268bd8fb92","tarball":"https://registry.npmjs.org/asset-smasher/-/asset-smasher-0.1.2.tgz","integrity":"sha512-iuPUdv1EKNWYauwRJPOLqtd0LM/lYdl+bYEl95is7Ft4RGYuu/8Uso+dUKRIgW+CgPc7noBypK5iEZ7vQRghSg==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCFFFc7+94TzVP4cXRVoHAIDStWZO6beYDmGIZKjAzVIwIhAIAySWeNO4DsbBPg1tGfx0vziXO2i0soOx2pC9ukxQPI"}]},"maintainers":[{"name":"jriecken","email":"jriecken@gmail.com"}]},"0.1.3":{"name":"asset-smasher","description":"Asset pre-processor, merger, and compressor.","version":"0.1.3","author":{"name":"Jim Riecken","email":"jriecken@gmail.com"},"keywords":["asset","compress","merge","preprocess"],"license":{"type":"MIT","url":"http://github.com/jriecken/asset-smasher/raw/master/LICENSE"},"repository":{"type":"git","url":"git://github.com/jriecken/asset-smasher.git"},"bugs":{"url":"http://github.com/jriecken/asset-smasher/issues"},"main":"./lib/asset-smasher.js","bin":{"asset-smasher":"./bin/asset-smasher"},"dependencies":{"async":"0.1.22","commander":"0.6.1","glob":"3.1.10","mkdirp":"0.3.3","minimatch":"0.2.5","uglify-js":"1.3.2","underscore":"1.3.3"},"optionalDependencies":{},"devDependencies":{},"engines":{"node":">= 0.6.0"},"readme":"# Asset Smasher\n\nAsset pre-processor, merger, and compressor for Node.js\n\n- [Structuring Your Assets](#structure-assets)\n - [Manifest Files](#manifest-files)\n- [Using via Command Line](#command-line)\n - [Helpers](#cli-helpers)\n - [Plugins](#cli-plugins)\n- [Using via Express Middleware](#express-middleware)\n- [Using via Programmatic Interface](#programmatic-interface)\n- [Transformer Notes](#transformer-notes)\n - [LESS](#tn-less)\n - [ejs](#tn-ejs)\n - [dust and Handlebars](#tn-dust-hbs)\n\n## Overview\n\nAsset Smasher is a command-line tool, express middleware, and programmatic interface for:\n\n- Pre-processing and transforming files down to plain JavaScript and CSS.\n - `.coffee` - Compile CoffeeScript into JavaScript\n - `.ejs` - Run a file through EJS (e.g. to populate configuration parameters into a JavaScript file)\n - `.less` - Compile Less into CSS\n - `.hbs` - Precompile Handlebars templates into JavaScript files that register them with `Handlebars.templates`.\n - `.dust` - Precompile Dust templates into JavaScript files that register them for use with `dust.render`.\n - Processors can be chained together. E.g `test.js.hbs.ejs` (run Handlebars template through EJS, then compile it)\n - Additional processors can be plugged in.\n- Merging files together using Manifest files (`.mf`) with dependency management directives similar to Sprockets.\n - `require` - Require a single file\n - `require_dir` - Require all the files in a specific directory\n - `require_tree` - Require all the files in a specific directory (and subdirectories)\n- Compressing, gzipping, and generating hashed file names.\n - Compress JavaScript files with `uglify-js`\n - Compress LESS during LESS preprocessing\n - Generate Gzipped versions of files\n - Include a MD5 hash of the file's contents in the file name. `myAsset.js` -> `myAsset-c89cba7b7df028e65cb01d86f4d27077.js`\n - `asset_path` helper that can be used to reference the hashed name.\n\nIt's released under the [MIT](http://en.wikipedia.org/wiki/MIT_License) license.\n\n## Structuring Your Assets\n\nAsset Smasher has the concept of \"asset paths\". These are locations in which your asset files will be located, and from which any relative asset paths will be rooted to.\n\nThe simplest structure has one asset path.\n\nE.g.\n\n Asset Paths\n -----------\n - app\n\n File Structure\n --------------\n app/\n js/\n css/\n images/\n\nA more complicated structure might be\n\n Asset Paths\n -----------\n - app\n - lib\n - vendor\n\n File Structure\n --------------\n app/\n js/\n css/\n images/\n lib/\n js/\n css/\n images/\n vendor/\n js/\n css/\n images/\n\nBoth of these examples will result in a compiled structure of\n\n js/\n css/\n images/\n\n### Manifest Files\n\nManifest (`.mf`) files are used to merge many assets into a single resulting file. The file should be named with the resulting file type before the `.mf` extension (e.g. `manifest.css.mf` or `manifest.js.mf`. *Manifest files can `require` other manifest files*\n\nA simple manifest file might look like\n\n # A comment here\n require \"./one.js\"\n require_dir \"./subdir1\"\n #\n # Another comment\n require_tree \"./subdir2\"\n\n**Directives:**\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
DirectiveDescription
require \"[path]\"\n Include a single file\n
    \n
  • \n If the path starts with \"/\", \"../\", or \"./\", process and include the specified file. The file must be\n inside one of the configured asset paths.\n
    • \n
  • \n If the path does not start with \"/\", \"../\", or \"./\", the file will be searched for in all of the configured\n asset paths. E.g. if there are asset paths one and two defined, require \"js/test.js\"\n will look for one/js/test.js and then two/js/test.js stopping when it finds a matching file.\n
    • \n
  • \n The filename part of the path does not have to include the whole extension. E.g require \"test\"\n finds the first file that matches the name in the asset paths (for example test.js.ejs)\n
    • \n
\n
require_dir \"[path]\"\n Include all the files in a directory\n
    \n
  • \n The path must be absolute, or relative to the current directory. E.g. you can do require_dir \"../some/other/dir\"\n but not require_dir \"somedir\"\n
    • \n
  • \n If using absolute paths, or \"..\" in your paths, the resulting directory needs to be inside one of the configured asset paths.\n
    • \n
  • \n Make sure the directory only contains assets of the type you want. E.g. for myManifest.js.mf, the dir required had better\n only contain javascript files, or else bad things will happen.\n
    • \n
\n
require_tree \"[path]\"\n Include the files in a directory recursively\n
    \n
  • The rules for require_tree are the same as the rules for require_dir
    • \n
\n
\n\n## Using via Command-Line\n\nUse `npm install -g asset-smasher` to install the `asset-smasher` command-line tool globally.\n\n asset-smasher --help\n\n Usage: asset-smasher [options] \n\n Options:\n\n -h, --help output usage information\n -V, --version output the version number\n --compress compress/minify the generated files\n --hash generate versions of the files with md5 hashes in the name\n --gzip generate gzipped versions of the compiled files\n --hashVersion invalidate all assets without changing file contents [1.0]\n --only only process the files matching these glob patterns (relative to any of the paths) [**/*]\n --paths list of paths to look for assets [.]\n --prefix prefix to append to logical paths when constructing urls. use if output dir is not served from the root of your web app []\n --helpers a .js module of helper functions require()s to expose to transforms []\n --plugins a .js plugin module []\n\n If --only is not specified, *all* files in the --paths will be processed.\n\n Examples:\n\n Compile all assets in the current directory to /home/me/compiledAssets\n\n $ asset-smasher /home/me/compiledAssets\n\n Something similar to what the Rails asset pipeline does by default\n\n $ asset-smasher --compress --hash --gzip --prefix=/assets \\\n --paths=./js,./css,./images \\\n --only **/*.{jpg,gif,png},application.js.mf,application.css.mf ./public/assets\n\n Compile assets, providing some custom helpers to the transformation\n\n $ asset-smasher --helpers helpers.js output\n\n### Helpers\n\nThere is a built-in `asset_path` helper that can be used to get the \"real\" (i.e. with hashed file name) path of an asset. E.g. `asset_path('css/myFile.css')` might return `'/assets/css/myFile-c89cba7b7df028e65cb01d86f4d27077.css`.\n\nSome transformers (e.g. the `.ejs` one) take in a set of local variables that they can use during transformation. You can pass in the path to a JavaScript module whose exports will be included in this set of variables.\n\nYou can use this, for example, to set configuration parameters in your JS files:\n\n**helper.js**\n\n exports.serviceUrl = 'http://my.service/';\n\n**config.js.ejs**\n\n //...\n var serviceUrl = '<%= serviceUrl %>';\n var cssLocation = '<%= asset_path('css/myFile.css') %>';\n //...\n\n**Execution**\n\n $ asset-smasher --helpers helper.js --only config.js.ejs,css/myFile.css .\n $ cat config.js\n var serviceUrl = 'http://my.service/';\n var cssLocation = '/assets/css/myFile-c89cba7b7df028e65cb01d86f4d27077.css';\n\n\n### Plugins\n\nIf there's a type of file you want to pre-process that is not natively supported by Asset Smasher, you can add it using a plugin file.\n\n*TODO: How to add additional transformers via a plugin file.*\n\n## Using via Express Middleware\n\nAsset smasher exposes an `express` middleware that can:\n\n- Serve your assets un-merged/mangled in development mode.\n- Serve precompiled assets (with hashed file names) in production mode.\n\nThe middleware takes in the same arguments as the `Smasher` constructor, with a few extras:\n\n- `serve` - boolean whether the middleware should serve the asset files. Usualy set this to `true` in development, `false` in production\n- `assetMapLocation` - path to the `map.json` generated by the command-line `asset-smasher` util. This allows the helper methods to determine what the hashed file names were\n\nThe middleware exposes two helpers to your views:\n\n- `js_asset(logicalPath)` - Render a `