Skip to content

Runners and Running Tests

ATAF ships with three preconfigured test runners. You can extend one of them or build your own using the framework's lifecycle utilities.

Preconfigured Runners

  • BasicJUnitRunner — for JUnit.
  • BasicTestNGRunner — for TestNG.
  • ParallelTestNGRunner — for parallel Cucumber scenario execution with TestNG.

To use one, simply extend it:

java
import ataf.core.runner.BasicTestNGRunner;

public class TestRunner extends BasicTestNGRunner {

}

Custom Runner

You can also build your own runner by providing the required lifecycle methods through RunnerUtils:

java
import ataf.core.utils.RunnerUtils;

public class CustomTestRunner {

    public void beforeTestSuite() {
        RunnerUtils.setupTestSuite();
    }

    public void afterTestSuite() {
        RunnerUtils.tearDownTestSuite();
    }
}

Running Tests

Cucumber

bash
mvn clean test -Dcucumber.filter.tags=@smoke

TestNG

bash
mvn clean test -DsuiteXmlFile=testng.xml

JUnit

bash
mvn clean test

Pass runtime credentials and test data secrets via system properties — see Runtime Credentials.