grunt-hash
Append a unique hash to the end of a filename for cache busting. For example:
examples/test1.js => examples/dist/test1.b93fd451.js
##Grunt 0.4
This task now depends on grunt 0.4.x. Please see the grunt 0.3 to 0.4 migration guide for more details.
If you are still using grunt 0.3, please install grunt-hash 0.1x
Getting Started
Install this grunt plugin next to your project's grunt.js gruntfile with: npm install grunt-hash
Then add this line to your project's grunt.js
gruntfile:
grunt.loadNpmTasks('grunt-hash');
Documentation
grunt.initConfig({
hash: {
options: {
mapping: 'examples/assets.json', //mapping file so your server can serve the right files
srcBasePath: 'examples/', // the base Path you want to remove from the `key` string in the mapping file
destBasePath: 'out/', // the base Path you want to remove from the `value` string in the mapping file
flatten: false, // Set to true if you don't want to keep folder structure in the `key` value in the mapping file
hashLength: 8, // hash length, the max value depends on your hash function
hashFunction: function(source, encoding){ // default is md5
return require('crypto').createHash('sha1').update(source, encoding).digest('hex');
}
},
js: {
src: 'examples/*.js', //all your js that needs a hash appended to it
dest: 'examples/dist/js/' //where the new files will be created
},
css: {
src: 'examples/*.css', //all your css that needs a hash appended to it
dest: 'examples/dist/css/' //where the new files will be created
}
}
});
grunt.loadNpmTasks('grunt-hash');
Configuration follow the multi-task standard configuration format: http://gruntjs.com/configuring-tasks
Contributing
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using grunt.
License
Copyright (c) 2012 Greg Allen
Licensed under the MIT license.