Running Risk Group Tests First
Reordering Risk Tests for JUnit and TestNG
Supported environments:
Ant and IntelliJ IDEA Project runners
JUnit and TestNG frameworks when tests are started with usual JUnit or TestNG tasks
tip
TeamCity also allows implementing tests reordering feature for a custom build runner.
You can instruct TeamCity to run some tests before others. You can do this on the build runner settings page. Currently, there are two groups of tests that TeamCity can run first:
recently failed tests, i.e. the tests failed in previous finished or running builds as well as tests having high failure rate (so-called blinking tests)
new and modified tests, i.e. tests added or modified in changelists included in the running build
note
The recently added or modified tests in your personal build have the highest priority, and these tests run even before any other reordered test.
TeamCity allows you to enable both of these groups or each one separately.
TeamCity operates on test case basis, that is not the individual tests are reordered, but the full test cases. The tests cases are reordered only within a single test execution Ant task, so to maximize the feature effect, use a single test execution task per build.
Tests reordering works the following way:
JUint
TeamCity provides tests that should be run first (test classes).
When a JUnit task starts, TeamCity checks whether it includes these tests.
If at least one test is included, TeamCity generates a new fileset containing included tests only and processes it before all other filesets. It also patches other filesets to exclude tests added to the automatically generated fileset.
After that JUnit starts and runs as usual.
note
Some cases when automatic tests reordering will not work:
if JUnit suites are created manually in test cases with help of suite() method
if @RunWith annotation is used in JUnit4 tests
TestNG
TestNG versions earlier than 5.14:
TeamCity provides tests that should be run first (test classes).
When a TestNG task starts, TeamCity checks whether it includes these tests.
If at least one test is included, TeamCity generates a new XML file with a suite containing included tests only and processes it before all other files. It also patches other files to exclude tests added to the automatically generated file.
After that TestNG starts and runs as usual.
note
Some cases when automatic tests reordering will not work if <package/> element is used in the TestNG XML suite.
TestNG versions 5.14 or later:
TeamCity provides tests that should be run first (test classes).
When a TestNG starts, TeamCity injects a custom listener which will reorder tests if needed.
Before starting tests TestNG asks listener to reorder tests execution order list. If some test requires reordering, TeamCity listener moves it to to the start of the list.
After that TestNG runs tests in new order.
note
Some cases when automatic tests reordering will not work:
if <test/> or <suite/> element in the TestNG XML suite has the
preserve-orderattribute set totrueif TestNG suite file in YAML format
Reordering Risk Tests for NUnit
Supported build runners:
NAnt, MSBuild, NUnit, Visual Studio 2003 build runners
NUnit testing framework
Tests reordering only supports reordering of recently failed tests.
note
When the "Run recently failed tests first" option is selected, the Explicit attribute will not work.
Test reordering is not supported for parametrized NUnit tests.
If risk tests reordering option is enabled, the feature for NUnit test runner works in the following way:
NUnit runs tests from the "risk" group using test name filter.
NUnit runs all other tests using inverse filter.
note
Since tests run twice, thus risk test fixtures Set Up and Tear Down will be performed twice.
Tests reordering feature applies to an NUnit task. That is, for NAnt and MSBuild runners, tests reordering feature will be initiated as many times as many NUnit tasks you have in your build script.