Awesome
grunt-preen
a grunt task plugin to run preen
Getting Started
This plugin requires Grunt ~0.4.1
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-preen --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-preen');
The "preen" task
Overview
Configuration is done by adding a preen property to your projects bower.json
file as explained here. You can also add arguments via the data object passed into grunt.initConfig()
.
Usage Examples
Default Options
In this example, preen is added to the default task in Gruntfile.js
.
grunt.registerTask('default', ['myTask', 'preen']);
or it can be runn via cli
grunt preen
Custom Targets
The only targets currently provided by preen are the preen:preview
target that logs what actions would have been taken if preen was run
grunt preen:preview
and preen:verbose
that logs all actions as they are run
grunt preen:verbose
Custom Options
The only option currently provided by preen is the directory
option. This allows you to override bower's default directory (or the one set in .bowerrc). This can be useful when using preen as part of your build pipeline. This can be added via the data object passed to grunt.initConfig()
options: {
directory: '.tmp/public/bower/files'
}
or it can be passed via the cli
grunt preen --directory ./tmp/public/bower/files
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.
Release History
- Aug 9, 2013 v1.0.0 preen and grunt-preen are ready to roll
- Nov 11, 2014 v1.1.0
- updated to accept both preview and verbose options
- Jan 30, 2015 v1.2.0
- updated to accept new directory option