HRF: Human readable log format

The human readable log format is designed to closely match an errors description produced by the Microsoft family of C++ compilers. This format allows jumping to the error location, if test module output is redirected into IDE output window. The rest of the log messages are designed to produce the most human friendly description of the events occurring in test module. This is a default format generated by test modules.

Here the list of events along with corresponding message and the condition that has to be satisfied for it to appear in the output.

Event	Condition	Output
On testing start	threshold != log_nothing	`Running <total number of test cases> test case(s) ...`
On testing start	threshold != log_nothing, show_build_info is set	Platform: $BOOST_PLATFORM Compiler: $BOOST_COMPILER STL : $BOOST_STDLIB Boost : $BOOST_VERSION
On abnormal testing termination	threshold <= log_messages	`Test is aborted`
On test unit start	threshold <= log_test_units	`Entering test <test unit type> <test unit name>`
On test unit end	threshold <= log_test_units; testing time is reported only if elapsed time is more than 1 us.	`Leaving test <test unit type> <test unit name>; testing time <value>`
On skipped test unit	threshold <= log_test_units	`Test <test unit type> <test unit name> is skipped`
On uncaught C++ exception	threshold <= log_cpp_exception_errors. Checkpoint message is reported only if provided	`unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>`
On resumable system error	threshold <= log_system_errors. Checkpoint message is reported only if provided	`unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>`
On fatal system error	threshold <= log_fatal_errors. Checkpoint message is reported only if provided	`unknown location(0): fatal error in <test case name>: <explanation> <last checkpoint location>: last checkpoint: <checkpoint message>`
On passed test assertion	threshold <= log_successful_tests	`<assertion location>: info: check<assertion expression> passed`
On failed WARNING level test assertion	threshold <= log_warnings	`<assertion location>: warning in <test case name>: condition <assertion description> is not satisfied`
On failed CHECK level test assertion	threshold <= log_all_errors	`<assertion location>: error in <test case name>: check <assertion description> failed`
On failed REQUIRE level test assertion	threshold <= log_fatal_errors	`<assertion location>: fatal error in <test case name>: critical check <assertion description> failed`
On test log message	threshold <= log_messages	`<Message content>`

The level of details concerning the error message depends on the testing tool producing the log entry.

Boost C++ Libraries

HRF: Human readable log format