grunt-lodash

grunt-lodash v0.4.0

A Grunt wrapper around the lodash command-line interface, lodash-cli.

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 i --save-dev grunt-lodash

Once grunt-lodash has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-lodash');

Overview

In your project’s Gruntfile, add a section named lodash to the data object passed into grunt.initConfig():

grunt.initConfig({
  'lodash': {
    'build': {
      // output location
      'dest': 'build/lodash.build.js',
      'options': {
        // modifiers for prepared builds
        // modern, strict, compat
        'modifier': 'modern'
      }
    }
  }
});

As you might have guessed, this would produce the same output as:

$ lodash modern -o build/lodash.build.js

Finally, include the lodash invocation in your desired build task:

grunt.registerTask('build', [
  'clean:dist',
  'lodash'
]);

Configuration options

For a more in-depth explanation of the build options head on over to the lodash-cli documentation.

'lodash': {
  'target': {
    // output location
    'dest': 'build/lodash.build.js'
  },
  'options': {
    // modifiers for prepared builds
    // modern, strict, compat
    'modifier': 'modern',
    'modularize': true,
    'category': ['collection', 'function'],
    'exports': ['amd', 'commonjs', 'node'],
    'iife': '!function(window,undefined){%output%}(this)',
    'include': ['each', 'filter', 'map'],
    'minus': ['result', 'shuffle'],
    'plus': ['random', 'template'],
    'template': './*.jst',
    'settings': '{interpolate:/\\{\\{([\\s\\S]+?)\\}\\}/g}',
    'moduleId': 'underscore',
    // with or without the --
    // these are the only tested options,
    // as the others don't make sense to use here
    'flags': [
      '--stdout',
      'development',
      '--production',
      'source-map'
    ],
    // with or without the -
    // these are the only tested options,
    // as the others don't make sense to use here
    'shortFlags': [
      'c',
      '-d',
      'p',
      '-m'
    ]
  }
}

Support

Tested in Node.js 0.8.28 & 0.10.35.
Note: Node.js 0.10.8-0.10.11 have bugs preventing minified builds.

The changelog for this release is available on our wiki.