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 -coverage

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 -coverage -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 -coverage -nopost

To force coverage to run (if you have set the enabledByDefault flag to false; see configuration options for details) you can turn it back on for a single test run using the folling command line option:

grails test-app -coverage

If you have the default configured to run coverage every time, you can override it using the -nocoverage flag on the command line:

grails test-app -nocoverage

For Maven users who would like to define utilize the -nopost and -xml flags but can't from the command line, they can be defined in BuildConfig.groovy:

coverage {
	nopost = true
	xml = true
}

Configuration Options:

coverage {
	enabledByDefault = false
}

You can add your own exclusions from the reports by adding an entry in your BuildConfig.groovy file like this:

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:

• GRAILSPLUGINS-1598: upgrade to cobertura 1.9.3
• GRAILSPLUGINS-1377: updating closure names in the xml report
• GRAILSPLUGINS-1278: plugins/code-coverage-1.1.5 files in WAR
• GRAILSPLUGINS-1516: ability to define xml output through configuration

• Added config and command line arguments to disable code coverage by default

• 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