libs/test/doc/html/boost_test/adv_scenarios.html

   1 <html>
   2 <head>
   3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   4 <title>Advanced Usage Scenarios</title>
   5 <link rel="stylesheet" href="../boostbook.css" type="text/css">
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   7 <link rel="home" href="../index.html" title="Boost.Test">
   8 <link rel="up" href="../index.html" title="Boost.Test">
   9 <link rel="prev" href="runtime_config/summary.html" title="Summary of run-time parameters">
  10 <link rel="next" href="adv_scenarios/build_utf.html" title="Building the Unit Test Framework">
  11 </head>
  12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13 <table cellpadding="2" width="100%"><tr>
  14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../boost.png"></td>
  15 <td align="center"><a href="../../../../../index.html">Home</a></td>
  16 <td align="center"><a href="../../../../../libs/libraries.htm">Libraries</a></td>
  17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19 <td align="center"><a href="../../../../../more/index.htm">More</a></td>
  20 </tr></table>
  21 <hr>
  22 <div class="spirit-nav">
  23 <a accesskey="p" href="runtime_config/summary.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="adv_scenarios/build_utf.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
  24 </div>
  25 <div class="section">
  26 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
  27 <a name="boost_test.adv_scenarios"></a><a class="link" href="adv_scenarios.html" title="Advanced Usage Scenarios">Advanced Usage Scenarios</a>
  28 </h2></div></div></div>
  29 <div class="toc"><dl class="toc">
  30 <dt><span class="section"><a href="adv_scenarios/build_utf.html">Building the <span class="emphasis"><em>Unit
  31       Test Framework</em></span></a></span></dt>
  32 <dt><span class="section"><a href="adv_scenarios/entry_point_overview.html">Test module's
  33       entry point</a></span></dt>
  34 <dt><span class="section"><a href="adv_scenarios/test_module_init_overview.html">Test
  35       module's initialization</a></span></dt>
  36 <dt><span class="section"><a href="adv_scenarios/test_module_runner_overview.html">Test
  37       module runner</a></span></dt>
  38 <dt><span class="section"><a href="adv_scenarios/single_header_customizations.html">Header-only
  39       variant customizations</a></span></dt>
  40 <dd><dl>
  41 <dt><span class="section"><a href="adv_scenarios/single_header_customizations/multiple_translation_units.html">Header-only
  42         with multiple translation units</a></span></dt>
  43 <dt><span class="section"><a href="adv_scenarios/single_header_customizations/entry_point.html">Customizing
  44         the module's entry point</a></span></dt>
  45 <dt><span class="section"><a href="adv_scenarios/single_header_customizations/init_func.html">Customizing
  46         the module's initialization function</a></span></dt>
  47 </dl></dd>
  48 <dt><span class="section"><a href="adv_scenarios/static_lib_customizations.html">Static-library
  49       variant customizations</a></span></dt>
  50 <dd><dl>
  51 <dt><span class="section"><a href="adv_scenarios/static_lib_customizations/entry_point.html">Customizing
  52         the module's entry point</a></span></dt>
  53 <dt><span class="section"><a href="adv_scenarios/static_lib_customizations/init_func.html">Customizing
  54         the module's initialization function</a></span></dt>
  55 </dl></dd>
  56 <dt><span class="section"><a href="adv_scenarios/shared_lib_customizations.html">Shared-library
  57       variant customizations</a></span></dt>
  58 <dd><dl>
  59 <dt><span class="section"><a href="adv_scenarios/shared_lib_customizations/entry_point.html">Customizing
  60         the module's entry point</a></span></dt>
  61 <dt><span class="section"><a href="adv_scenarios/shared_lib_customizations/init_func.html">Customizing
  62         the module's initialization function</a></span></dt>
  63 </dl></dd>
  64 <dt><span class="section"><a href="adv_scenarios/external_test_runner.html">The external
  65       test runner usage variant</a></span></dt>
  66 <dt><span class="section"><a href="adv_scenarios/obsolete_init_func.html">The obsolete
  67       initialization function</a></span></dt>
  68 </dl></div>
  69 <p>
  70       If you are reading this chapter, this means that the wide range of tools and
  71       interfaces covered in the previous sections are not sufficient for the testing
  72       scenario you have in mind. You are here to bend the <span class="emphasis"><em>Unit Test Framework</em></span>
  73       to your will and ... we are not going to stop you. Instead we'll try to guide
  74       you so that some dark corners do not look scary.
  75     </p>
  76 <p>
  77       In most cases the <span class="emphasis"><em>Unit Test Framework</em></span> is going to be supplied
  78       for you either as part of your system libraries or set of libraries used by
  79       your companies. Yet if you are facing the necessity to build your own static
  80       or dynamic library of the <span class="emphasis"><em>Unit Test Framework</em></span> or need
  81       to customize the build for any reason, section <a class="link" href="adv_scenarios/build_utf.html" title="Building the Unit Test Framework">Building
  82       the <span class="emphasis"><em>Unit Test Framework</em></span></a> covers all the necessary
  83       steps.
  84     </p>
  85 <p>
  86       To streamline the experience of setting up your test module, the <span class="emphasis"><em>Unit
  87       Test Framework</em></span> provides some default initialization logic for them.
  88       Usually the default test module initialization will work just fine, but if
  89       you want to implement some custom initialization or change how default initialization
  90       behaves you need to first look in <span class="bold"><strong>Test module initialization</strong></span>
  91       section. Here you'll learn about various options the <span class="emphasis"><em>Unit Test Framework</em></span>
  92       provides for you to customize this behavior.
  93     </p>
  94 <p>
  95       The part of the framework which loads, initializes and executed your test module
  96       is called the <span class="bold"><strong>Test Runner</strong></span>. Each usage variant
  97       comes with default test runner. If, instead, you prefer to implement your own
  98       entry point into the test module (for example if you need to implement the
  99       <code class="computeroutput"><span class="identifier">main</span></code> function yourself and
 100       not use the one provided by the <span class="emphasis"><em>Unit Test Framework</em></span>, you
 101       need to learn about <span class="emphasis"><em>Unit Test Framework</em></span> interfaces involved
 102       in test runners operations. These are covered in the <span class="bold"><strong>Test
 103       runners</strong></span> section. Let me reiterate that you only need to this section
 104       if regular regular options for customization of initialization logic like
 105       <a class="link" href="tests_organization/fixtures.html" title="Fixtures">fixtures</a> or
 106       <a class="link" href="tests_organization/decorators.html" title="Decorators">decorators</a>
 107       are not sufficient for your purposes.
 108     </p>
 109 </div>
 110 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
 111 <td align="left"></td>
 112 <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
 113       contributors<p>
 114         Distributed under the Boost Software License, Version 1.0. (See accompanying
 115         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
 116       </p>
 117 </div></td>
 118 </tr></table>
 119 <hr>
 120 <div class="spirit-nav">
 121 <a accesskey="p" href="runtime_config/summary.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="adv_scenarios/build_utf.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
 122 </div>
 123 </body>
 124 </html>