Test module runner

A test module runner is an orchestrator or a driver that, given the test tree, ensures the test tree is initialized, tests are executed and necessary reports generated. It performs the following operations:

initialize the test module using the supplied initialization function;
select output media for the test log and the test results report;
execute test cases as specified by run-time parameters;
produce the test results report;
generate the appropriate return code.

The Unit Test Framework comes with the default test runner. There is no need to call it explicitly. The default generated test module's entry point invokes the default test runner. The default test runner is declared with the following signature:

namespace boost { namespace unit_test {

  typedef bool (*init_unit_test_func)();

  int unit_test_main( init_unit_test_func init_func, int argc, char* argv[] );

} }

The test runner may return one of the following values:

Value	Meaning
`boost::exit_success`	No errors occurred during testing, or the success result was forced with command-line argument `--[link boost_test.utf_reference.rt_param_reference.result_code`result_code`]=no`.
`boost::exit_test_failure`	Non-fatal errors detected and no uncaught exceptions were thrown during testing, or the initialization of the Unit Test Framework failed.
`boost::exit_exception_failure`	Fatal errors were detected, or uncaught exceptions thrown during testing.

An advanced test runner may provide additional features, including interactive GUI interfaces, test coverage and profiling support.

Boost C++ Libraries

Test module runner