NUnit-Gui Command Line Options

The forms interface may be run with or without the name of a file containing tests on the command line. If the program is started without any file specified, it automatically loads the most recently loaded assembly.

Note: Options that take values may use an equal sign, a colon or a space to separate the option from its value.

Run without loading an Assembly

To suppress loading of the most recent assembly, use the /noload switch: 

        nunit-gui /noload

Specifying an Assembly

The other option is to specify an assembly or project file name on the command line. The following will start the forms interface with the assembly nunit.tests.dll: 

        nunit-gui nunit.tests.dll

The following will start the forms interface loading the same assembly through its Visual Studio project definition: 

        nunit-gui nunit.tests.csproj

Assuming an NUnit test project has been created containing the assembly, the following will again load nunit.tests.dll: 

        nunit-gui nunit.tests.nunit

Specifying an Assembly and a Fixture

When specifying a a fixture, you must give the full name of the test fixture along with the containing assembly. For example, to load only the NUnit.Tests.AssertionTests in the nunit.tests.dll assembly use the following command: 

        nunit-gui /fixture:NUnit.Tests.AssertionTests nunit.tests.dll

The name specified after the /fixture option may be that of a TestFixture class, or a namespace. If a namespace is given, then all fixtures under that namespace are loaded. This option may be used with Visual Studio or NUnit projects as well.

Specifying the Version of the CLR

As an alternative to using the config file, you may run NUnit under a different version of the CLR by use of the /framework option. For example, to run the gui using an installed version of the .Net 2.0 framework, use:

       nunit-gui /framework:v2.0.50727

The version to be used must be specified in the form shown and, of course, must be installed on your system for the command to work.

Note: If you use a <startup> section in the config file, it takes precedence over this option.

Load and Run Tests

Normally, nunit-gui only loads an assembly and then waits for the user to click on the Run button. If you wish to have the tests run immediately, use the /run option: 
        nunit-gui nunit.tests.dll /run

Specifying which Configuration to Load

When loading a Visual Studio project or an NUnit project, the first configuration found will be loaded by default. Usually this is Debug. The configuration loaded may be controlled using the /config switch. The following will load the Release configuration of the nunit.tests.dll: 

        nunit-gui nunit.tests.csproj /config:Release

Note: This option has no effect when loading an assembly directly.

Specifying Multiple Assemblies

The forms interface does not currently provide for specifying more than one assembly on the command line. Multiple-assembly projects must be loaded by specifying the name of a Visual Studio solution file or an NUnit test project.

Displaying Help

The /help or /? option displays a message box containing a brief help message.