Advertisement

Summary
This article describes how to use Artima SuiteRunner as a JUnit runner to run your existing JUnit test suites.

Artima SuiteRunner is a free open source testing toolkit for Java released under the Open Software License. You can use this tool with JUnit to run existing JUnit test suites, or standalone to create unit and conformance tests for Java APIs. To get you up and running quickly, the Artima SuiteRunner distribution ZIP file includes a simple example. This article uses the example to show you how to use Artima SuiteRunner to run existing JUnit test suites.

When you unzip the Artima SuiteRunner distribution ZIP file, you get the following items:

Name	Contents
account.srj	Recipe file for the example
accountjunit.srj	Recipe file for the JUnit example (Added in 1.0beta4)
example	Directory of Java source and class files for the example
javadoc	Directory containing Javadoc documentation for the API
README.txt	The obligatory README file
suiterunner-[release].jar	Artima SuiteRunner executable JAR file
suiterunner-[release]-src.zip	ZIP file of Artima SuiteRunner source code
xmlreporter.srj	Recipe file for the XMLReporter example (Added in 1.0beta5)

Artima SuiteRunner's executable JAR file is suiterunner-[release].jar. The source and class files for the example are found in the example directory. A recipe file that runs the example JUnit test suite is contained in accountjunit.srj, which was added to the distribution in 1.0beta4. If you don't see accountjunit.srj, then you need to download the latest version of Artima SuiteRunner.