PetaTest/Doc/running_tests.md

PetaTest - Running PetaTest Projects

With PetaTest there is no external "runner" program - it's all built in to your unit test project. To run your tests, simply run your project's output .exe file.

By default PetaTest will generate reports to the console - so you can view the progress of the tests as they run. On completion, you'll be prompted to view a full report in your browser. Press 'Y' to show the report.

You can control this behaviour with the command line options shown below.

Command Line Options

• /showreport[:yes|no] - automatically show the HTML report instead of prompting (default = prompt)
• /htmlreport[:yes|no] - generate the HTML report (default = yes)
• /dirtyexit[:yes|no] - terminate the process on completion rather than cleanly shutting down (faster in some cases)
• /runall[:yes|no] - run all tests even if one or more are marked as active
• /verbose - show Console.WriteLine output in the console while the test runs
• /out:<filename> - name of the HTML file to generate - defaults to report.html in the current directory.

Active Tests

Often during debugging and development you'll want to run just a single test. You can mark such a test with the Active property. For example:

[Test(Active=true)]
public void Test1()
{
    // This will run
}

[Test]
public void Test2()
{
    // This won't
}

It also works for paremeterized inputs:

[Test("Hello", Active=true)]
[Test("World")]
public void Test(string input)
{
    // This will only run once with "Hello" input
}

and it works on test fixtures too.

[TestFixture(Active=true)]
public class MyTests
{
    ...
}

You can apply the Active flag to multiple tests and test fixtures and all those marked will be run. If nothing is marked as active then all tests are run.