]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | [/ |
2 | / Copyright (c) 2003 Boost.Test contributors | |
3 | / | |
4 | / Distributed under the Boost Software License, Version 1.0. (See accompanying | |
5 | / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) | |
6 | /] | |
7 | ||
8 | ||
9 | [section:test_output Controlling outputs] | |
10 | The output produced by a test module is one of the major assets the __UTF__ brings to users. In comparison with any | |
11 | kind of manual/assert based solution the __UTF__ provide following services: | |
12 | ||
13 | [variablelist | |
14 | [[All test errors are reported uniformly][ | |
15 | The test execution monitor along with standardized output from all included | |
16 | [link boost_test.testing_tools testing tools] provides uniform reporting for all errors | |
17 | including fatal errors, like memory assess violation and uncaught exceptions.]] | |
18 | [[Detailed information on the source of an error][ | |
19 | The __UTF__ test tool's based assertion provides as much information as possible about cause of error, | |
20 | usually allowing you to deduce what is wrong without entering the debugger or core analysis.]] | |
21 | [[Separation of the test errors description (test log) from the results report summary (test results report)][ | |
22 | The information produced during test execution, including all error, warning and info messages from the test | |
23 | tools, executed test units notification constitute the *test log*. | |
24 | ||
25 | Once testing is completed the __UTF__ may produce a summary *test report* with | |
26 | different levels of detail.]] | |
27 | [[Flexibility in what is shown in the output][ | |
28 | The __UTF__ provides the ability to configure what is shown in both the test log and the test report. The | |
29 | configuration is supported both at runtime (from the command line) and at compile time from within a | |
30 | test module.]] | |
31 | [[Flexibility in how output is formatted][ | |
32 | The __UTF__ provides the ability to configure the format of the test module output. At the moment only | |
33 | [link boost_test.test_output.log_formats three formats] | |
34 | are supported by the __UTF__ itself. However the well defined public interface allows you to | |
35 | [link boost_test.test_output.logging_api.custom_log_formatter customize] an output for | |
36 | your purposes.]] | |
37 | ] | |
38 | ||
39 | ||
40 | [include test_tools_support.qbk] | |
41 | [include log_format.qbk] | |
42 | [include report_format.qbk] | |
43 | [include logger_api.qbk] | |
44 | ||
45 | [include progress_display.qbk] | |
46 | [include testout_summary.qbk] | |
47 | ||
48 | [endsect] [/test_output] |