grunt-generate-configs

grunt-generate-configs

CLI to generate separate grunt configuration files automatically

This command will take your big, fat grunt configuration object and automatically generate separate files to store the task configuration objects in. It's a one time operation to be done before you start using load-grunt-configs

Generates config files in following formats:

• json (default)
• js module
• coffee module
• cson
• yaml

Getting Started

This plugin requires Grunt ~0.4.2

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-generate-configs -g

We install it globally, so you can reuse it for all your projects. Once the plugin has been installed, you can run it from the command line in the directory of your project:

generate_configs

The command will parse your grunt configuration object and automatically create files for each task.

Command line options

• --target=<dir> you can specify the output directory using the target-flag. E.g.: grunt generate_configs --target=foo will create a foo directory instead of config.
• --type=[js|json|coffee|cson|yaml|yml] allows you to output the configuration objects as json, yaml, cson, coffee or js files.
• --json, --coffee, --cson, --js, --yaml and --yml as shorthand for type=<type>. The type flag will always override any shorthands.

Examples

For example, if this is your grunt configuration inside Gruntfile.js:

grunt.initConfig({
    jshint   : {
        all     : [
            'Gruntfile.js', 'tasks/*.js', '<%=nodeunit.tests%>'
        ],
        options : {
            jshintrc : '.jshintrc',
        },
    },

    // Before generating any new files, remove any previously-created files.
    clean    : {
        config : ['config'],
    },

    // Unit tests.
    nodeunit : {
        tests : ['tests/*_test.js'],
    },
});

It will create the files jshint.json, clean.json and nodeunit.json inside a config directory, containing the configuration objects:

//file: config/jshint.json
{
  "all": [
    "Gruntfile.js",
    "tasks/*.js",
    "<%=nodeunit.tests%>"
  ],
  "options": {
    "jshintrc": ".jshintrc"
  }
}

//file: config/clean.json
{
  "config": [
    "config"
  ]
}

//file: config/nodeunit.json
{
  "tests": [
    "tests/*_test.js"
  ]
}

Once these files are generated, use the load-grunt-configs module to automatically load all configuration files:

npm install load-grunt-configs --save-dev

and inside your Gruntfile.js replace the grunt configuration object with:

var configs = require('load-grunt-configs')(grunt);
grunt.initConfig(configs);

See the project for more information, options and examples: load-grunt-configs

Example output

• json
• js
• yaml
• coffee
• cson: TODO

Changelog

v0.5.1

• Use util.inspect for js generation
• Add cson support
• Fix incorrect testing
• Update .travis.yml to test all branches
• Remove support for node < v0.10

v0.5.0

• Update unit tests to include all flags
• Expose main method for parsing of grunt config obj
• Add js, coffee, yaml, json flags
• Separate filegen to lib and add removal of config dir upon overwrite

v0.4.1

• Makes the command global

v0.4.0

• adds cli

v0.3.0

• Adds demos
• Adds yaml support
• Adds Coffeescript support

v0.2.0

• Test all possibilities, idiot!
• fixes #2, incorrect ext for js files

v0.1.2

• Fixes #1, moved inquirer from devDeps to deps

v0.1.1

• keywords, keywords, keywords, sigh

v0.1.0

• Fixes CLI options examples
• creates task grunt-generate-configs

License

Copyright (c) 2014 Camille Reynders Licensed under the MIT license.