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