ConvertBot: Runs a set of unit tests.

2020-04-27T22:05:06Z

Runs a set of unit tests.

New page

Runs a set of unit tests.
<pre>
<OPT> The option to run the unit tests for or the name of the individual test
class to run. [DEF=SYS]
<RES> The table to write the results of running the tests to. [OPTIONAL]

This will run a complete set of unit tests for an option tree. At the conclusion
of running the tests the results will be written to the table named <RES> or
will be printed to the terminal (if <RES>="").

The names of the individual tests will be read in from the unittest_config.tbl
file that should be in the test/junit directory of the indicated option tree.
The structure of the option tree should look like this:
opt
+- lib
| +- Foo (The class to test, nxm.opt.lib.Foo)
+- libg
| +- Bar (Another class to test, nxm.opt.libg.Bar)
+- test
+- junit
+- unittest_config.tbl (List of the available unit tests)
+- lib
+- FooTest (JUnit test class, nxm.opt.test.junit.lib.FooTest)
+- libg
+- BarTest (JUnit test class, nxm.opt.test.junit.libg.BarTest)

To run the test cases for a single unit test file set <OPT> to the full name
of the unit test file (e.g. "nxm.sys.test.junit.lib.UtilTest") or give the full
name of the NeXtMidas class being tested (e.g. "nxm.sys.lib.Cache").

Examples:
1. Run the unit tests for the SYS option tree:
nM> unittest SYS

2. Run the unit tests for the SYS option tree but with limited output:
nM> unittest/verbose=0 SYS

3. Run the unit tests in the class file nxm.sys.test.junit.lib.UtilTest:
nM> unittest nxm.sys.test.junit.lib.UtilTest

4. Run the unit tests for the class nxm.sys.lib.Cache:
nM> unittest nxm.sys.lib.Cache

5. Build one of the unit tests in the SYS option tree
nM> build FileUtilTest test/junit/lib sys
-OR-
nM> build junit/lib/FileUtilTest.java test sys

Switches:
/VERBOSE Turns on/off the printing to the console of the results for testing
each method.

/FAILURE Prints an informational message about each failure (this is turned
on by default if VERBOSE is on and off if VERBOSE is off).

/ERROR Prints an informational message about each error (this is turned
on by default if VERBOSE is on and off if VERBOSE is off).

/ST Print a stack trace to accompany any error or failure error messages
(this has no affect if FAILURE and ERROR are both off).

SEE ALSO: CONFIDENCE, nxm.sys.test.junit.NMTestCase

</pre>

[[Category:NXM_Explain]]

UNITTEST - Revision history

ConvertBot: Runs a set of unit tests.