Advertisement

Summary
This article introduces the main features of Artima SuiteRunner by demonstrating how to start Artima SuiteRunner, debug a failed test, select and run Suites, select and run JUnit TestCases, and edit and save recipe files.

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 introduce the main features of Artima SuiteRunner. This article will show you how to start Artima SuiteRunner using a recipe file, debug a failed test, select and run Suites, select and run JUnit TestCases, and edit and save recipe files.

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 is contained in account.srj.