Obsolete: TestRunner was a command line program that let us execute FitNesse tests and suites in a batch mode. The TestRunner protocol has been deprecated by FitNesse. To run FitNesse tests from the command line, we now use the FitNesse Command Line REST Commands.

The following applies only to old versions of FitNesse and fitSharp.

By default, TestRunner loads the assemblies specified by the FitNesse path command, but you can override this.

Test results are written by default in a plain text format that can be formatted using a FitNesse Java class. See http://fitnesse.org/FitNesse.UserGuide.FormattingOption. Test results can also be written in XML format.

To use:

    c:\apps\fitsharp\runner
        -r fitnesse.fitserver.TestRunner
        [-a appconfig] [-c suiteconfig] [-debug] [-nopaths] [-results resultFile] [-format text|xml] [-suiteFilter filtertag] [-v]
        host port pageName [assemblies]

where:

• appconfig is the name of an App Config File
• suiteconfig is the name of a Suite Configuration File,
• debug prints trace information to the console,
• nopaths prevents the addition of assemblies from the FitNesse path command,
• resultFile is the name of a file (or 'stdout') where test results are written,
• format specifies the format of the test results
• filtertag is a tag that restricts the pages to be executed
• v (verbose) prints test progress to the console
• host is the name of the machine running the FitNesse wiki server,
• port is the port used by the FitNesse wiki server,
• pageName is the test page or test suite to be run,
• assemblies is a list of additional assemblies to load, seperated by ';'

Example:

    c:\apps\fitsharp\runner
        -r fitnesse.fitserver.TestRunner
        -results myResults.txt localhost 8080 MySuite