# <nunit2>

Runs tests using the NUnit V2.6 framework.

The `haltonfailure` attribute is only useful when more than one test suite is used, and you want to continue running other test suites although a test failed.

Set `failonerror` to false to ignore any errors and continue the build.

In order to run a test assembly built with NUnit 2.0 or 2.1 using <nunit2> task, you must add the following node to your test config file :

    <configuration>
        ...
        <runtime>
            <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
                <dependentAssembly>
                    <assemblyIdentity name="nunit.framework" publicKeyToken="96d09a1eb7f44a77" culture="Neutral" />
                    <bindingRedirect oldVersion="2.0.6.0" newVersion="2.2.8.0" />
                    <bindingRedirect oldVersion="2.1.4.0" newVersion="2.2.8.0" />
                </dependentAssembly>
            </assemblyBinding>
        </runtime>
        ...
    </configuration>

See the NUnit home page for more information.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
haltonfailure | bool | Stop the test run if a test fails. The default is false. | False
labels | bool | Indicate whether or not to label the text output as the tests run. | 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:

#### <test>

Tests to run.

#### </test>

#### <formatter>

Formatters to output results of unit tests.

#### </formatter>

### Examples

- Run tests in the `MyProject.Tests.dll` assembly.

      <nunit2>
          <formatter type="Plain" />
          <test assemblyname="MyProject.Tests.dll" appconfig="MyProject.Tests.dll.config" />
      </nunit2>

- Only run tests that are not known to fail in files listed in the `tests.txt` file.

      <nunit2>
          <formatter type="Xml" usefile="true" extension=".xml" outputdir="${build.dir}/results" />
          <test>
              <assemblies>
                  <includesfile name="tests.txt" />
              </assemblies>
              <categories>
                  <exclude name="NotWorking" />
              </categories>
              <references basedir="build">
                  <include name="Cegeka.Income.Services.dll" />
                  <include name="Cegeka.Util.dll" />
              </references>
          </test>
      </nunit2>

### Requirements

Assembly: NAnt.NUnit2Tasks (0.92.4543.0)