grunt-lcov-merge

Grunt plugin to merge lcov files from multiple test runs, for use with a tool like coveralls.

This fork is intended to update grunt to 1.x since the original repo seems dead.

Getting Started

This plugin requires Grunt 0.4.0

To install, add grunt-lcov-merge to your package.json. The easiest way to do that is

1npm install grunt-lcov-merge --save-dev

Once the plugin has been installed, you'll need to enable it in your Gruntfile by adding

1grunt.loadNpmTasks('grunt-lcov-merge');

You can then run with

1grunt lcovMerge

Options

emitters

Type: Array Default: ['file']

What emitters to send the merged data to. Supported emitters are 'file', which sends the merged data to a file, and 'event', which sends it out to the 'coverage' event and can be listened to with

1grunt.event.on('coverage', function(lcov, done) {});

outputFile

Type: String Default coverage/lcov-merge.info

If a file emitter is specified, this is the output file to pipe data to.

Example

1    grunt.initConfig({
2    jshint: {
3        src: ['Gruntfile.js', 'tasks/**/*.js', 'test/**/*.js'],
4        options: {
5            jshintrc: true
6        }
7    },
8
9    mocha_istanbul: {
10      coverage: {
11          src: 'test/**/*.spec.js',
12          options: {
13              coverageFolder: 'build/coverage',
14              reportFormats: ['lcov'],
15          }
16      }
17    },
18
19    lcovMerge: {
20      options: {
21          emitters: ['event', 'file'],
22          outputFile: 'mergeLcov.info'
23      },
24      src: ['build/coverage/*.info', 'build/coverage/**/*.info']
25    }
26  });
27
28  grunt.event.on('coverage', function(lcov, done) {
29    // See below
30    done();
31  });
32
33  grunt.loadNpmTasks('grunt-lcov-merge');

Note that grunt-lcov-merge allows for source files to be specified via any file format.

Event emitter

One of the most useful ways to consume this plugin is to use the coverage event to send the lcov data to a service like coveralls:

1grunt.event.on('coverage', function(lcov, done) {
2    require('coveralls').handleInput(lcov, function(err) {
3        if (err) {
4          return done(err);
5        }
6        done();
7    });

Using the coveralls module means that Travis-CI can automatically send your merged LCOV to coveralls.

Version History

• 0.1.0 - Initial version
• 0.1.1 - Trim down the number of files in the distribution
• 0.1.2. - Update dependencies, work around coveralls issue.
• 0.1.3 - Documentation updates
• 1.0.0 - Official release