grunt-test-matrix

Run a grunt command against your travis test matrix

Getting Started

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-test-matrix --save-dev

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

grunt.loadNpmTasks('grunt-test-matrix');

Alternatively, install task-master and let it manage this for you.

The "testMatrix" task

Overview

In your project's Gruntfile, add a section named testMatrix to the data object passed into grunt.initConfig(). Each target must have, at minimum, a task property. task can be a string of space separated tasks and/or arguments to pass to grunt or an array of tasks and/or arguments.

grunt.initConfig({
  testMatrix: {
    mocha: {
      task: 'mocha:unit mocha:integration'
    },
    karma: {
      task: ['coffee', 'build', 'karma']
    }
  }
});

Options

quiet

Suppress logging. Default false.

global

Prefix the beginning of the command with the global npm binary path. Default true. Set to false to use a local copy of grunt (i.e. ./node_modules/.bin/grunt).

install

Set to true to install only missing node.js versions or to false to skip missing versions. The default is 'latest' which means, install the most recent node version matching a range, even if another installed version satisfies that range. This is the default because it's closest to how your code will run on travis.

versions

By default, testMatrix uses the versions of node specified in your .travis.yml file, but you can override that with this property.

Contributing

Please see the contribution guidelines.