Next Phenomenal Microbrewery

    extend-grunt-plugin

    0.1.0 • Public • Published

    extend-grunt-plugin

    Helper method to easily extend a grunt plugin.

    About

    Reusing a grunt plugin from inside your own plugin is not as straightforward as expected. This small module takes care of forwarding the configurations from your plugin to whatever other plugin you need to use.

    Install

    You can install this module using npm:

    npm install extend-grunt-plugin --save-dev

    Usage

    Giving that you are actually creating your grunt task as a separate plugin, let's assume that you want to invoke the grunt-bump plugin from inside your task. First of all make sure that you have installed the desired dependency (in this case grunt-bump) locally in your project using npm.

    Here is what the setup should look like:

    var extendGruntPlugin = require('extend-grunt-plugin');
     
    module.exports = function (grunt) {
      grunt.registerMultiTask('my_awesome_task', function () {
     
        var options = this.options({
          pushTo: 'origin' // Overrides default value from grunt-bump
        });
     
        // Creates "bump" and "bump-only" targets on grunt, that can be run later
        // Values that user sets for "my_awesome_task" will be forwarded to these tasks
        extendGruntPlugin(grunt, require('grunt-bump'), {
          'bump': options,
          'bump-only': options // Creates a "bump-only" target
        });
     
        // Runs the "bump" subtask :)
        grunt.task.run('bump');
      });
    };

    Multi tasks

    Grunt multi tasks are those that allows you to define different targets. Many grunt plugins are multi-tasks, in order to correctly configure it, always define your options using modulename.target notation. See what it looks like in the example below:

    var extendGruntPlugin = require('extend-grunt-plugin');
     
    module.exports = function (grunt) {
      grunt.registerMultiTask('my_awesome_task', function () {
     
        var options = {
          src: "https://raw.githubusercontent.com/ruyadorno/extend-grunt-plugin/master/index.js",
          dest: "testfile.js"
        };
     
        // Creates a "curl.getstuff" target on grunt, that can be run later
        extendGruntPlugin(grunt, require('grunt-curl'), {
          'curl.getstuff' : options
        });
     
        // Runs the "curl:getstuff" subtask :)
        grunt.task.run('curl:getstuff');
      });
    };

    License

    Released under the MIT License.

    Keywords

    none

    Install

    npm i extend-grunt-plugin

    DownloadsWeekly Downloads

    97

    Version

    0.1.0

    License

    none

    Last publish

    Collaborators

    • ruyadorno