gulp-test-rigging

Simple Node.js library to simplify generating reports on unit tests, code-coverage, and code styling locally and in files consumable by Jenkins. Uses mocha, istanbul, and xo.

Install

1npm install --save gulp-test-rigging

Usage

To use the module, simply require it in your gulpfile.js after "gulp" and pass "gulp" as a parameter.

1var gulp = require('gulp');
2require('gulp-test-rigging')(gulp);
3
4gulp.task('default', ['validate']);

This adds the following tasks to your gulpfile:

• run-lint - Runs xo on your source files and prints results to the console.
• run-lint-jenkins - Runs xo on your source files and outputs the results to a file.
• run-tests - Runs mocha and istanbul, printing results to the console.
• run-tests-jenkins - Runs mocha and istanbul, outputting the results for each to files.
• validate - Runs both "run-lint" and "run-tests".
• validate-jenkins - Runs both "run-lint-jenkins" and "run-tests-jenkins".
• watch-lint - Runs "run-lint" as a Gulp watch task.
• watch-tests - Runs "run-tests" as a Gulp watch task.
• watch-validate - Runs "validate" as a Gulp watch task.

Options

Options may be passed to the module following the "gulp" parameter in the require statement. The following lists the available options and their default values:

1{
2	paths: {
3		src: ['app.js'],
4		test: ['test/**/*spec.js', 'test/**/*test.js']
5	},
6	lintReporter: 'checkstyle',
7	lintOutputDir: './lint-results',
8	lintOutputFile: 'results.xml',
9	testOutputDir: './test-results',
10	testOutputFile: 'results.xml',
11	coverageReporter: 'mocha-jenkins-reporter',
12	coverageOutputFormat: ['cobertura']
13}

License

Licensed under the MIT license.