Home > The Unit Test Framework > User's guide > Usage variants > External test runner

The external test runner variant of the UTF

All other usage variants employ the build-in test runners. If you plan to use an external test runner with your test module you need to build it as a dynamic library. This usage of the UTF is called the external test runner variant of the UTF. The variant requires you to define the flag BOOST_TEST_DYN_LINK either in a makefile or before the header boost/test/unit_test.hpp inclusion. An external test runner utility is required to link with dynamic library.

If an external test runner is based on the test runner built in to the dynamic library (like the standalone boost_test_runner utility supplied by the UTF), it requires you to implement the test module initialization function that matches the alternative initialization function signature. The UTF provides an ability to automatically generate an empty test module initialization function with correct signature if no custom initialization is required by a test module.

[Note] Note

An advanced test runner doesn't have to be based on the build-in one and may require a different test module initialization function signature and/or name.