Unit tests are basically bits of code that exercise functions within a project. If each test cases passes, there is a good chance the system is in proper working order. That is by no means guaranteed, and verifying this falls into the realm of integration testing, and which is performed manually.
The JSwat unit tests are written to use the JUnit framework. This provides the classes for automating the execution of the tests, making it very easy to run the tests over and over again.
To run the test suite you will need the latest version of the Jakarta Ant tool,
maintained by the Apache
group. While the process could be accomplished without Ant, it
would take longer to explain than it does to install this
extraordinarily useful tool. After installing Ant, you will need to
copy the junit.jar
file (which you get from the JUnit
website) to the
lib
directory in the Ant installation directory. In
this way, Ant can easily run JUnit tests using the
junit
tag.
With Ant installed and JSwat compiled, running the unit tests is
a simple process. Open a command shell window and change to the
top-level JSwat directory (where the README.html
file
is found). From there, invoke Ant with the "test" target,
like so: ant test
Soon after invoking this command you will see the JSwat window appear and start reacting to the test code. Wait until the window closes and Ant has finished running the tests.
It is important that the tests are performed in the top-level directory. Otherwise many of the tests will fail to work correctly. In particular, the classpath and sourcepath are set using relative paths, and the Java parser test uses a relative file path to load one of the test files.
The best way to learn about writing test cases is to look at the
existing test code. It is generally very simple and
straight-forward code. Bear in mind that any new test cases must be
added to the appropriate collection (e.g. AllTests
,
ActiveTests
, etc.) within the particular Java package.
Otherwise they will not be run when the test suite is executed.