chore(tests): add coverage as an option

Knowing what exactly isn't being covered by the tests is more
important than knowing the statistics.

By default, this outputs full HTML reports with indicators of which
lines or branches haven't aren't covered.

Author: chrisirhc

.gitignore

@@ -14,6 +14,8 @@ pids
 logs
 results
 dist
+# test coverage files
+coverage/
 
 node_modules
 npm-debug.log

Gruntfile.js

@@ -141,14 +141,10 @@ module.exports = function(grunt) {
         browsers: ['Firefox']
       },
       coverage: {
-        singleRun: true,
         preprocessors: {
           'src/*/*.js': 'coverage'
         },
-        reporters: ['progress', 'coverage'],
-        coverageReporter: {
-          type : 'text'
-        }
+        reporters: ['progress', 'coverage']
       }
     },
     changelog: {
@@ -330,14 +326,19 @@ module.exports = function(grunt) {
     grunt.task.run(['concat', 'uglify']);
   });
 
-  grunt.registerTask('test', 'Run tests on singleRun karma server', function (subTask) {
+  grunt.registerTask('test', 'Run tests on singleRun karma server', function () {
     //this task can be executed in 3 different environments: local, Travis-CI and Jenkins-CI
     //we need to take settings for each one into account
     if (process.env.TRAVIS) {
       grunt.task.run('karma:travis');
-    } else if (subTask === 'coverage') {
-      grunt.task.run('karma:coverage');
     } else {
+      var isToRunJenkinsTask = !!this.args.length;
+      if(grunt.option('coverage')) {
+        var karmaOptions = grunt.config.get('karma.options'),
+          coverageOpts = grunt.config.get('karma.coverage');
+        grunt.util._.extend(karmaOptions, coverageOpts);
+        grunt.config.set('karma.options', karmaOptions);
+      }
       grunt.task.run(this.args.length ? 'karma:jenkins' : 'karma:continuous');
     }
   });

README.md

@@ -94,6 +94,9 @@ Check the Grunt build file for other tasks that are defined for this project.
 
 This will start Karma server and will continously watch files in the project, executing tests upon every change.
 
+#### Test coverage
+Add the `--coverage` option (e.g. `grunt test --coverage`, `grunt watch --coverage`) to see reports on the test coverage. These coverage reports are found in the coverage folder.
+
 ### Customize templates
 
 As mentioned directives from this repository have all the markup externalized in templates. You might want to customize default