clover-merge
Description
The <clover-merge> task merges several Clover databases into one, to allow for combined reports to be generated. The resultant database can be used with reporting tasks, such as <clover-report> or <clover-log>, using the initstring parameter.
Parameters
Attribute | Description | Required |
|---|---|---|
initstring | The location to write the Clover coverage database resulting from the merge. | Yes. |
update | If set to true and there is an existing database at | No. Defaults to 'false'. |
updateSpan | If update is true, this span is used when merging any existing database at | No. Defaults to |
Nested Elements of <clover-merge>
<cloverDb>
Specifies a Clover database to merge.
Parameters
Attribute | Description | Required |
|---|---|---|
initstring | The | Yes. |
span | Specifies how far back in time to include coverage recordings from since the last Clover build for this database. See Using Spans. | No; default includes 'all coverage data found'. |
<cloverDbSet>
Specifies an Ant FileSet of Clover databases to merge. Apart from those shown below, parameters and sub-elements are the same as for an Ant FileSet.
Parameters
See the Ant FileSet documentation for parameters and sub-elements available on FileSets.
Attribute | Description | Required |
|---|---|---|
refid | Lets you specify a fileset that references a group of Clover database files. This references a fileset defined elsewhere. | No; defaults to none. |
span | Specifies how far back in time to include coverage recordings from since the last Clover build for this database. See Using Spans. | No; defaults to '0 seconds'. |
Examples
This example produces a merged database containing the measured coverage of project A and project B:
<clover-merge initString="mergedcoverage.db">
<cloverDb initString="projectAcoverage.db"/>
<cloverDb initString="projectBcoverage.db" span="30 mins"/>
</clover-merge>
This example produces a merged database containing the measured coverage of all databases found under /home/projects:
<clover-merge initString="mergedcoverage.db">
<cloverDbSet dir="/home/projects" span="30 mins">
<include name="**/coverage.db"/>
</cloverDbSet>
</clover-merge>