benbria
Istanbul and JSCoverage-style instrumentation for CoffeeScript files.
Benbria CoffeeCoverage
Instruments CoffeeScript files for code coverage. Compiles .coffee files to .js files, and adds JSCoverage or Istanbul style instrumentation for the original coffee script source.
Features
- Native coffeescript instrumentation - not based on source maps
- Conditional instrumentation with pragmas
- Support for nyc style instrumentation
- Support for Istanbul style instrumentation
- Support for JSCoverage style instrumentation
- Support for Streamline compiler style instrumentation
- Dynamic instrumentation - instrument your code at run time
- Precompiled instrumentation
Quick Start
Assuming you have a folder named "test" full of mocha tests, which directly loads your .coffee files, then from your project's folder, run:
$ npm install --save-dev coffee-coverage
$ npm install --save-dev istanbul
$ mocha --recursive --compilers coffee:coffeescript/register --require coffee-coverage/register-istanbul test
$ ./node_modules/.bin/istanbul reportYou should now have an Istanbul coverage report in ./coverage/lcov-report/index.html.
If this doesn't quite do what you're after, check out our tutorials below:
Tutorials:
- Mocha and Istanbul Guide
- Mocha and JSCoverage Guide
- Istanbul and Tape Guide courtesy @jessaustin.
- Codeship and Coveralls
- Travis-CI and Coveralls
- Ignoring code with Pragmas
Have coffee-coverage working in a setup not described above? Raise an issue and let us know how you're using coffee-coverage, so we can document it here.
What it Does
Benbria CoffeeCoverage is a tool for determining the coverage of your unit tests. It does this by instrumenting .coffee files to see how often each line, branch, or function is executed. CoffeeCoverage is capable of producing both Istanbul and JSCoverage style instrumentation.