2 FitNesseRun - essenius/FitNesseRun GitHub Wiki

The FitNesseRun task allows you to run a FitNesse test or suite on an existing FitNesse installation, or by executing a local instance of FitNesse on the agent. The result is transformed into an NUnit 3 file that can be published to Azure DevOps via a Publish Test Results task. With this task, you can execute a FitNesse test suite as part of your build or automated deployment scenario.

You can execute FitNesseRun in two modes. The Call mode executes a test on a running FitNesse instance by calling FitNesse’s REST APIs. This means that FitNesse can run anywhere, as long as the build server can access it via http or https. The Execute mode starts a new FitNesse instance on the build server with a command line parameter to make it execute the desired test case or suite, and then quit (“single shot mode”). Which mode to choose depends on your test scenario. For example, if you want to test assemblies as part of your build, then the Execute mode makes it possible to easily access the assemblies to be tested, since FitNesse runs on the build server. It will also provide additional security since FitNesse only runs when it executes a test. The Call mode is easier to configure and works well if the test cases and fixtures are relatively static, and you can access the application under test remotely (e.g. for regressing testing the REST APIs of your application).

These are the parameters that you can configure for this task:

Common section

Parameter	Description	Default
Command	The mechanism to run the FitNesse test (`Call`/`Execute`)	`Call`
Working Directory	The working directory of the FitNesseRun task	`.`
Test or Suite to run	the test or suite page that the task needs to run
Result Folder	The folder where the output files will be placed	`.`
Include HTML	Whether to include a readable HTML result file	`true`
Extra Parameters	Extra variables to be passed to the FitNesse test/suite

Notes:

Command: Call if using a REST call to an existing FitNesse instance; Execute if running FitNesse in 'single shot' mode on the agent
extra parameters: format is name1=value1&name2=value2. This can be used to override the value of variables in FitNesse

Call section (only used if Command is `Call`)

Parameter	Description	Default
Base URI	The URI of the existing FitNesse instance used	`http://localhost:8080`

Execute section (only used if Command is `Execute`)

Parameter	Description	Default
Desired Port	The port that the FitNesse to be executed should run on	`9123`
Data Folder	The folder for the FitNesse data	`.`
Fixture Folder	The working directory of the FitNesse process, where it expects the fixtures	`.`
Application Search Root	The root folder where the task starts searching for FitNesse and FitSharp	`.`