Test Code Coverage Plugin

This plugin will generate code coverage reports using Cobertura.

Please create issues in JIRA if you encounter problems.

• JIRA Grails-CodeCoverage
• SVN Grails-CodeCoverage
• Author Homepage

To install:

For Grails 1.1

grails install-plugin code-coverage

For Grails versions prior to version 1.1

grails install-plugin code-coverage 0.9

To run:

grails test-app

Output is written to test/report/cobertura directory. Just open the index.html file.

If you are using a Grails version prior to 1.1, you need to use the provided script:

grails test-app-cobertura

Command line options:

grails test-app -xml

The plugin does some post processing on the HTML reports to make the Controller action names appear in human readable form (like Controller.list instead of Controller.$_closure1 ). If you don't require this or it is too resource intensive, you can tell the plugin to skip post processing of HTML files by passing the -nopost flag.

grails test-app -nopost

The default is to run coverage whenever tests are run, but there may be times you would like to bypass this default (for speed of test execution, for example). You can do this by using the -nocoverage flag on the command line:

grails test-app -nocoverage

In some versions the default is reversed so you have to specify this argument to generate the coverage reports.

grails test-app -coverage

Configuration Options:

coverage {
	exclusions = ["**/ExcludedController*", "**/excludedDir/**"]
}

The exclusions are by class name, and package, not path. Here's some more examples, that will filter out jsecurity classes and richui classes, if you are running cobertura with webtest.:

//cobertura exclusions
coverage {
	exclusions = [
	              '**/de/andreasschmitt/richui/taglib/renderer/**',
	              '**/plugins/richui-0.4/src/groovy/de/andreasschmitt/richui/**',
	              '**/de/andreasschmitt/richui/image/**',
	              '**/org/jsecurity/**',
	              '**/org/jsecurity/grails/**',
	              '**/JsecDbRealm*',
	              '**/*TagLib*/**',
	              "**/*Tests*",
	              '**/JsecAuthBase*',
	              '**/JsecurityFilters*']
}

By default, the plugin excludes several items from the coverage results including:

"**/*BootStrap*",
        "Config*",
        "**/*DataSource*",
        "**/*resources*",
        "**/*UrlMappings*",
        "**/*Tests*",
        "**/grails/test/**",
        "**/org/codehaus/groovy/grails/**",
        "**/PreInit*",
        "*GrailsPlugin*"

As of version 1.1.4, you can completely override the default list of exclusions and provide your own.

coverage {
	exclusionListOverride = [
        "**/grails/test/**",
        "*GrailsPlugin*"]
}

In addition, you can add directories to the default list for source files to include in the coverage reports. For example, if you're using the Jsecurity plugin and want to see the source for files in the 'realms' directory in the reports, add the following to your BuildConfig.groovy:

coverage {
     // list of directories to search for source to include in coverage reports
     sourceInclusions = ['grails-app/realms']
}

Release History:

• Change from using Config.groovy to BuildConfig.groovy to configure exclusions and custom properties

• support for Grails 1.1 RC2
• upgraded to Cobertura 1.9
• Removed TestAppCobertura script, plugin now utilizes the events framework to tie into the main Grails test-app script
• added ability to override exclusions through config.coverage.exclusionListOverride
• added ability to bypass generation of code coverage through the -nocoverage flag

• support for Grails 1.1

• added post processing of HTML reports to display human readable names for controller actions (Controller.list instead of Controller.$_closure1)

• Support for Grails 1.0.4 (deprecated Events.groovy and use _Events.groovy instead)
• added default exclusions for the Grails Testing Plugin (grails/test/ and org/codehaus/groovy/grails/)

• add sourceInclusions config option

• updated the default codeCoverageExclusionList in TestAppCobertura.groovy to exclude 'Config' rather than '*Config*'

• Added scriptEnv = "test" so you no longer need to specify the environment when running the test-app-cobertura script
• fixed a bug where project specific exclusions were not being loaded correctly