ceph/src/boost/libs/test/doc/test_output/test_output.qbk

   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]