This is a description of the basic features of
Folder Runner.
| name | file system | with | new | file system |
The test files used in the following examples are from
Sample Input Files and
Sample Output Files.
| with | file system |
| make empty folder | testoutput |
| alias folder | doc\fitnesse\FitnesseDotNet\SampleOutputFiles | as | out |
| alias folder | doc\fitnesse\FitnesseDotNet\SampleInputFiles | as | in |
Folder Runner runs the FIT tests from the files in an input directory and writes the results to an output directory.
| with | new | folder runner story |
| run | -c,doc\fitnesse\FitnesseDotNet\SampleInputFiles\SampleConfig.xml |
Test result counts are accumulated for all files processed.
| check | results | 5 right, 1 wrong, 0 ignored, 0 exceptions |
| with | file system |
| ensure | file | testoutput\SampleSimpleTest.html | same as | out\SampleSimpleTest.html |
Sub-directories are traversed and copied to a matching structure in the output directory.
| ensure | file | testoutput\SampleSubFolder\SampleFailingTest.html | same as | out\SampleFailingTest.html |
If a file SuiteSetUp.html exists in a folder, it is run before all other files in that folder.
| ensure | file | testoutput\SampleSubFolder\SuiteSetUp.html | same as | out\SampleSuiteSetUp.html |
If a file does not contain any tables, the contents are copied without changes.
| ensure | file | testoutput\SampleSubNoTest\SampleNoTest.html | same as | in\SampleSubNoTest\SampleNoTest.html |
A file reportIndex.html is created in the output directory with the FIT results of each file processed and links to the output files.
| ensure | file | testoutput\reportIndex.html | same as | out\SampleReportIndex.html |
A file fit.css is created in the output directories with the styles used by FIT to highlight test results. (This is a bit inconsistent because the test files must already have a link to this stylesheet file.)
| ensure | file | testoutput\fit.css | same as | doc\fitnesse\fit.css |
| ensure | file | testoutput\SampleSubFolder\fit.css | same as | doc\fitnesse\fit.css |
If a file fit.css already exists in the input directory, it is copied to the output directory and not overwritten with the standard version.
| ensure | file | testoutput\SampleSubWithStyle\fit.css | same as | in\SampleSubWithStyle\fit.css |
The fit.css file is only creates in sub-directories where test results are written.
| not | file | testoutput\SampleSubNoTest\fit.css | exists |
The input can be a single file.
| with | new | folder runner story |
| run | -c,doc\fitnesse\FitnesseDotNet\SampleInputFiles\SampleConfig.xml ,-i,doc\fitnesse\FitnesseDotNet\SampleInputFiles\SampleSimpleTest.html |
| check | results | 1 right, 0 wrong, 0 ignored, 0 exceptions |
XML output can be created.
| with | new | folder runner story |
| run | -c,doc\fitnesse\FitnesseDotNet\SampleInputFiles\SampleConfigXmlOutput.xml |
| with | file system |
| ensure | file | testoutput\XmlOutput.xml | same as | out\SampleXmlOutput.xml |
Files and directories can be excluded.
| with | new | folder runner story |
| run | -c,doc\fitnesse\FitnesseDotNet\SampleInputFiles\SampleConfig.xml,-x,Sample |
| check | results | 0 right, 0 wrong, 0 ignored, 0 exceptions |