The DCL includes all of the source code for ClarionTest, an automated test runner loosely patterned after .NET unit testing tools like nUnit.
You create your tests as procedures inside a special DLL, then you point ClarionTest at your test DLL. ClarionTest loads up your DLL, locates all the test procedures, and then gives you the option of running some or all of those tests.
ClarionTest components include:
- The ClarionTest.exe test running utility
- A global template which must be added to each test .APP you create.
- A set of procedures to facilitate unit testing, including:
- AssertThat
- SetUnitTestFailed (usually only used if AssertThat isn't applicable)
- IsEqualTo (usually used as a parameter to AssertThat)
- IsNotEqualto (usually used as a parameter to AssertThat)
- A test procedure template
- A group procedure template
For an example of how to use ClarionTest please see The problem with embeds, part 3: Testing the TXA parser.
For an explanation of how to create test apps see Creating a ClarionTest test DLL.