# <nunitreport>

[This is preliminary documentation and subject to change.]

A task that generates a summary HTML from a set of NUnit xml report files. Loosely based on Erik Hatcher JUnitReport for Ant.

This task can generate a combined HTML report out of a set of NUnit result files generated using the XML Result Formatter. By default, NUnitReport will generate the combined report using the NUnitSummary.xsl file located at the assembly's location, but you can specify a different XSLT template to use with the

    xslfile

attribute. Also, all the properties defined in the current project will be passed down to the XSLT file as template parameters, so you can access properties such as nant.project.name, nant.version, etc.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
out | string | Name of Output HTML file. | True
xslfile | string | XSLT file used to generate the report. | False
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Nested Elements:

#### <fileset>

Set of XML files to use as input

#### </fileset>

### Examples

-                   <nunitreport
                          out="${outputdir}\TestSummary.html"
                          >
                       <fileset>
                          <include name="${outputdir}\Test-*.xml" />
                       </fileset>
                    </nunitreport>

### Requirements

Assembly: NAnt.Contrib.Tasks (0.93.5002.0)