Nuclear Pumpkin Mocha

    grunt-hook

    0.3.1 • Public • Published

    grunt-hook

    Allows hooking tasks to grunt from other files.

    Getting Started

    This plugin requires Grunt ~0.4.5.

    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-hook --save

    Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

    grunt.loadNpmTasks('grunt-hook');

    The "hook" task

    Overview

    In your project's Gruntfile, add a task named hook as "placeholder" to run all the injected tasks. This task will run all the tasks you injected.

    Example

    module.exports = function(grunt) {
      grunt.registerTask('default', ['jshint', 'hook']);
    };

    Usage

    Injection Grunt tasks

    1. Create _Gruntfile.js on your package.
    2. Export function with arguments of function(grunt)
    3. Extend the config with the function grunt.config.extend()
    4. Add your task to the task list by using grunt.hook.push(task[, weight]);
      1. task - name of the task
      2. weight - weight to load the task [default: 0] (lower is earlier)
    • If you loading a new grunt-plugin, you should add the npm-dependencies to directory of the _Gruntfile.js
    • You can extend the watch task in order to add watch tasks...

    Example

    'use strict';
     
    module.exports = function(grunt) {
      grunt.loadNpmTasks('grunt-contrib-concat');
     
      grunt.config.merge({
        concat: {
          dist: {
            src: ['*.js'],
            dest: 'test-concat.js'
          }
        }
      });
     
      //Inject the task to the task list
      grunt.hook.push('concat', 10);
    };

    Changing the patterns of the files

    You can change the patterns of the files by adding hookPatterns to your config.

    Example

    module.exports = function(grunt) {
      grunt.loadNpmTasks('grunt-contrib-concat');
     
      grunt.initConfig({
        hookPatterns: ['_Gruntfile.js', '**/_Gruntfile.js', '!node_modules/**']
      });
    };

    Projects that uses grunt-hook

    You can learn from use-cases of projects that uses grunt-hook:

    1. Mean.io - Mean.io used grunt-hook to allow creating new tasks to the general flow of the framework by 3rd-party packages(like mean-compass).
    2. Mean-Compass - Mean-compass is example for hook-package that implement the grunt-hook plugin.

    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

    (0.3.0) Renaming the package (0.2.0) loading outside the task (0.1.0) initial release

    Install

    npm i grunt-hook

    DownloadsWeekly Downloads

    21

    Version

    0.3.1

    License

    none

    Last publish

    Collaborators

    • almogbaku