2007-03-22 10:39:43 +00:00

139 lines
4.8 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
-->
<document>
<properties>
<title>Maven Clover plugin goals</title>
<author email="dion@apache.org">dIon Gillard</author>
<author email="vmassol@apache.org">Vincent Massol</author>
</properties>
<body>
<section name="Registering a Clover report">
<p>
The typical way to use the Clover plugin is by registering a Clover
report in your <code>project.xml</code>:
</p>
<source><![CDATA[
<reports>
<report>maven-clover-plugin</report>
[...]
</reports>
]]></source>
</section>
<goals>
<goal>
<name>clover</name>
<description>
This is the default goal. It compiles the project code with Clover,
executes the unit tests and generate Clover reports by calling the
<code>clover:report</code> goal.
</description>
</goal>
<goal>
<name>clover:test</name>
<description>
Compiles the project code with Clover and executes the unit tests.
</description>
</goal>
<goal>
<name>clover:test-single</name>
<description>
Execute a single unit test and view the test coverage result directly
using the Clover Swing viewer. This is useful if you wish to quickly
see the action that a single unit test has on the code it tests.
</description>
</goal>
<goal>
<name>clover:report</name>
<description>
Generate Clover test coverage reports with Clover. There are 3
possible reports: HTML, XML or Swing. Whether a report is generated
is controlled by the <code>maven.clover.report.[report name]</code>
<a href="properties.html">properties</a>. The generated reports show
exactly what lines of your code were exercised by your tests.
</description>
</goal>
<goal>
<name>clover:xml-report</name>
<description>
Generate an XML test coverage report with Clover.
</description>
</goal>
<goal>
<name>clover:html-report</name>
<description>
Generate an HTML test coverage report with Clover.
</description>
</goal>
<goal>
<name>clover:swing-report</name>
<description>
Generate a Swing test coverage report with Clover.
</description>
</goal>
<goal>
<name>clover:on</name>
<description>
Activates Clover, which means that any other plugin calling the Ant
<code>javac</code> task will find its code compiled with Clover. This
is useful for example to Clover Cactus tests:
<code>maven clover:on cactus</code>.
</description>
</goal>
<goal>
<name>clover:off</name>
<description>
Deactivates Clover, resetting back the normal <code>javac</code> compiler.
</description>
</goal>
<goal>
<name>clover:check</name>
<description>
Fail the build if the test coverage percentage is below a defined
threshold.
</description>
</goal>
<goal>
<name>clover:save-history</name>
<description>
Saves a Clover history point that will then be used for generating
history reports when the <code>clover:report</code> goal is called.
</description>
</goal>
<goal>
<name>clover:merge</name>
<description>
Merges several Clover databases into one. This goal is meant to be
called in the top level master project (multiproject). It is called
automatically by the <code>clover:multiproject</code> goal.
</description>
</goal>
<goal>
<name>clover:multiproject</name>
<description>
Runs Clover on a multiproject and merge the Clover databases.This
goal does not generate a report; call clover:report for that or add
Clover as a report in your POM.
</description>
</goal>
</goals>
</body>
</document>