Test Runner is a command line program that lets you execute FitNesse tests and suites in a batch mode.

By default, Test Runner 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 fitnesse.org/FitNesse.CommandLineTestRunner. Test results can also be written in XML format.

To use:

    TestRunner [-c config] [-debug] [-nopaths] [-results resultFile] [-format text|xml] [-suiteFilter filtertag] [-v]
        host port pageName [assemblies]

where:

• config is the name of a Suite Configuration File,
• debug prints Fit Server actions 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 or an application configuration file to load, seperated by ';'

Example:

    TestRunner -results myResults.txt localhost 8080 MySuite