<!-- 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. --> <html> <head> <meta http-equiv="Content-Language" content="en-us"></meta> <link rel="stylesheet" type="text/css" href="style.css"> <title>XMLListener AntUnit Listener</title> </head> <body> <h2><a name="xmllistener">XML AntUnit Listener</a></h2> <h3>Description</h3> <p>Writes reports similar to the "xml" JUnit formatter. Some information that appears as attributes for the JUnit formatter has been turned into elements to allow streaming of the report.</p> <p>The AntUnit distribution comes with two XSLT stylesheets (in the etc subdirectory of the binary or the src/etc directory of the source release) that can be used together with Ant's <junitreport> task to create reports about your AntUnit tests.</p> <h3>Parameters</h3> <table border="1" cellpadding="2" cellspacing="0"> <tr> <td valign="top"><b>Attribute</b></td> <td valign="top"><b>Description</b></td> <td align="center" valign="top"><b>Required</b></td> </tr> <tr> <td valign="top">toDir</td> <td valign="top">Directory where testreports will be written to. Defaults to the project's basedir.</td> <td align="center">No.</td> </tr> <tr> <td valign="top">logLevel</td> <td valign="top">Log level for messages from the tests to include in the report. Must be one of: none, error, warn, warning, info, verbose, and debug. Messages at the given level or below will be included.</td> <td align="center">No. Default is 'none'.</td> </tr> </table> <h3>Examples</h3> <pre> <au:antunit failonerror="false" errorproperty="antunit-failure"> <fileset dir="${tests}" includes="*.xml"/> <au:xmllistener toDir="${reportsdir}"/> </au:antunit> <junitreport> <fileset dir="${reportsdir}" includes="*.xml"/> <report format="frames" styledir="${antunit-styles}" todir="${reportsdir}-frames"/> </junitreport> <fail if="antunit-failure">At least one test has failed</fail> </pre> <p>Runs AntUnit on all XML files in the directory <code>${tests}</code> writing XML reports to the directory <code>${reportsdir}</code> (which must exist upfront). Based on the XML reports a consolidated HTML frame report is created in <code>${reportsdir}-frames</code> using the stylesheets mentioned above. <code>${antunit-styles}</code> must point to the directory containing the stylesheets.</p> </body> </html>