Sākums Izpētīt Palīdzība
Reģistrēties Pierakstīties
devn00b
/
EQ2EMu
9
3
Atdalīts 0
Faili Problēmas 59
Koks: 37313e0645
Atzari Tagi
EQ2EMu
/
EQ2
/
source
/
depends
/
boost_1_72_0
/
libs
/
test
/
doc
/
html
/
boost_test
/
tests_organization
/
decorators
/
suite_level_decorators.html

suite_level_decorators.html 15 KB
Vēsture Neapstrādāts

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201 
  1. <html>
    2. 

  2. <head>
    3. 

  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
    4. 

  4. <title>Suite-level decorators</title>
    5. 

  5. <link rel="stylesheet" href="../../../boostbook.css" type="text/css">
    6. 

  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
    7. 

  7. <link rel="home" href="../../../index.html" title="Boost.Test">
    8. 

  8. <link rel="up" href="../decorators.html" title="Decorators">
    9. 

  9. <link rel="prev" href="../decorators.html" title="Decorators">
    10. 

  10. <link rel="next" href="explicit_decorator_declaration.html" title="Explicit decorator declaration">
    11. 

  11. </head>
    12. 

  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    13. 

  13. <table cellpadding="2" width="100%"><tr>
    14. 

  14. <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../../boost.png"></td>
    15. 

  15. <td align="center"><a href="../../../../../../../index.html">Home</a></td>
    16. 

  16. <td align="center"><a href="../../../../../../../libs/libraries.htm">Libraries</a></td>
    17. 

  17. <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
    18. 

  18. <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
    19. 

  19. <td align="center"><a href="../../../../../../../more/index.htm">More</a></td>
    20. 

  20. </tr></table>
    21. 

  21. <hr>
    22. 

  22. <div class="spirit-nav">
    23. 

  23. <a accesskey="p" href="../decorators.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../decorators.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="explicit_decorator_declaration.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
    24. 

  24. </div>
    25. 

  25. <div class="section">
    26. 

  26. <div class="titlepage"><div><div><h4 class="title">
    27. 

  27. <a name="boost_test.tests_organization.decorators.suite_level_decorators"></a><a class="link" href="suite_level_decorators.html" title="Suite-level decorators">Suite-level
    28. 

  28.         decorators</a>
    29. 

  29. </h4></div></div></div>
    30. 

  30. <p>
    31. 

  31.           Similarly to test case it is possible to apply list of decorators to test
    32. 

  32.           suite. It is done by specifying a list of decorators as the second argument
    33. 

  33.           to the macro <a class="link" href="../../utf_reference/test_org_reference/test_org_boost_auto_test_suite.html" title="BOOST_AUTO_TEST_SUITE"><code class="computeroutput"><span class="identifier">BOOST_AUTO_TEST_SUITE</span></code></a> or the third
    34. 

  34.           argument to the macro <a class="link" href="../../utf_reference/test_org_reference/test_org_boost_test_suite_fixture.html" title="BOOST_FIXTURE_TEST_SUITE"><code class="computeroutput"><span class="identifier">BOOST_FIXTURE_TEST_SUITE</span></code></a>.
    35. 

  35.         </p>
    36. 

  36. <h6>
    37. 

  37. <a name="boost_test.tests_organization.decorators.suite_level_decorators.h0"></a>
    38. 

  38.           <span class="phrase"><a name="boost_test.tests_organization.decorators.suite_level_decorators.example_descr"></a></span><a class="link" href="suite_level_decorators.html#boost_test.tests_organization.decorators.suite_level_decorators.example_descr">Example:
    39. 

  39.           Test suite decorators</a>
    40. 

  40.         </h6>
    41. 

  41. <div class="informaltable"><table class="table">
    42. 

  42. <colgroup><col></colgroup>
    43. 

  43. <thead><tr><th>
    44. 

  44.                   <p>
    45. 

  45.                     Code
    46. 

  46.                   </p>
    47. 

  47.                 </th></tr></thead>
    48. 

  48. <tbody><tr><td>
    49. 

  49. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_TEST_MODULE</span> <span class="identifier">decorator_02</span>
    50. 

  50. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">test</span><span class="special">/</span><span class="identifier">included</span><span class="special">/</span><span class="identifier">unit_test</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
    51. 

  51. <span class="keyword">namespace</span> <span class="identifier">utf</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">unit_test</span><span class="special">;</span>
    52. 

  52. 

  53. <span class="identifier">BOOST_AUTO_TEST_SUITE</span><span class="special">(</span><span class="identifier">suite1</span><span class="special">,</span> <span class="special">*</span> <span class="identifier">utf</span><span class="special">::</span><span class="identifier">label</span><span class="special">(</span><span class="string">"trivial"</span><span class="special">))</span>
    54. 

  54. 

  55.   <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span><span class="identifier">test_case1</span><span class="special">)</span>
    56. 

  56.   <span class="special">{</span>
    57. 

  57.     <span class="identifier">BOOST_TEST</span><span class="special">(</span><span class="keyword">true</span><span class="special">);</span>
    58. 

  58.   <span class="special">}</span>
    59. 

  59. 

  60.   <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span><span class="identifier">test_case2</span><span class="special">)</span>
    61. 

  61.   <span class="special">{</span>
    62. 

  62.     <span class="identifier">BOOST_TEST</span><span class="special">(</span><span class="number">1</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
    63. 

  63.   <span class="special">}</span>
    64. 

  64. 

  65. <span class="identifier">BOOST_AUTO_TEST_SUITE_END</span><span class="special">()</span>
    66. 

  66. </pre>
    67. 

  67.                 </td></tr></tbody>
    68. 

  68. </table></div>
    69. 

  69. <div class="informaltable"><table class="table">
    70. 

  70. <colgroup><col></colgroup>
    71. 

  71. <thead><tr><th>
    72. 

  72.                   <p>
    73. 

  73.                     Output
    74. 

  74.                   </p>
    75. 

  75.                 </th></tr></thead>
    76. 

  76. <tbody><tr><td>
    77. 

  77. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="special">&gt;</span> <span class="identifier">decorator_02</span> <span class="special">--</span><span class="identifier">run_test</span><span class="special">=</span><span class="error">@</span><span class="identifier">trivial</span>
    78. 

  78. <span class="identifier">Running</span> <span class="number">2</span> <span class="identifier">test</span> <span class="identifier">cases</span><span class="special">...</span>
    79. 

  79. 

  80. <span class="special">***</span> <span class="identifier">No</span> <span class="identifier">errors</span> <span class="identifier">detected</span>
    81. 

  81. </pre>
    82. 

  82.                 </td></tr></tbody>
    83. 

  83. </table></div>
    84. 

  84. <p>
    85. 

  85.           How a test suite decorator affects the processing of the test units inside
    86. 

  86.           of it varies with the decorator and is described for each decorator in
    87. 

  87.           subsequent sections. For instance, the function of the decorator in the
    88. 

  88.           above example is that when tests are filtered by label <code class="computeroutput"><span class="string">"trivial"</span></code>,
    89. 

  89.           every test unit in suite <code class="computeroutput"><span class="identifier">suite1</span></code>
    90. 

  90.           will be run.
    91. 

  91.         </p>
    92. 

  92. <p>
    93. 

  93.           Similar to C++ namespace test suite can be closed and reopened within the
    94. 

  94.           same test file or span more than one file and you are allowed to apply
    95. 

  95.           different decorators in each point, where test suite is opened. If this
    96. 

  96.           is the case, the list of decorators applied to the test suite is the union
    97. 

  97.           of decorators specified in each place. Here an example.
    98. 

  98.         </p>
    99. 

  99. <h6>
    100. 

  100. <a name="boost_test.tests_organization.decorators.suite_level_decorators.h1"></a>
    101. 

  101.           <span class="phrase"><a name="boost_test.tests_organization.decorators.suite_level_decorators.example_descr0"></a></span><a class="link" href="suite_level_decorators.html#boost_test.tests_organization.decorators.suite_level_decorators.example_descr0">Example:
    102. 

  102.           Decorators on multiple suite openings</a>
    103. 

  103.         </h6>
    104. 

  104. <div class="informaltable"><table class="table">
    105. 

  105. <colgroup><col></colgroup>
    106. 

  106. <thead><tr><th>
    107. 

  107.                   <p>
    108. 

  108.                     Code
    109. 

  109.                   </p>
    110. 

  110.                 </th></tr></thead>
    111. 

  111. <tbody><tr><td>
    112. 

  112. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_TEST_MODULE</span> <span class="identifier">decorator_03</span>
    113. 

  113. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">test</span><span class="special">/</span><span class="identifier">included</span><span class="special">/</span><span class="identifier">unit_test</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
    114. 

  114. <span class="keyword">namespace</span> <span class="identifier">utf</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">unit_test</span><span class="special">;</span>
    115. 

  115. 

  116. <span class="identifier">BOOST_AUTO_TEST_SUITE</span><span class="special">(</span><span class="identifier">suite1</span><span class="special">,</span> <span class="special">*</span> <span class="identifier">utf</span><span class="special">::</span><span class="identifier">label</span><span class="special">(</span><span class="string">"trivial"</span><span class="special">))</span>
    117. 

  117. 

  118.   <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span><span class="identifier">test_case1</span><span class="special">)</span>
    119. 

  119.   <span class="special">{</span>
    120. 

  120.     <span class="identifier">BOOST_TEST</span><span class="special">(</span><span class="keyword">true</span><span class="special">);</span>
    121. 

  121.   <span class="special">}</span>
    122. 

  122. 

  123. <span class="identifier">BOOST_AUTO_TEST_SUITE_END</span><span class="special">()</span>
    124. 

  124. 

  125. <span class="identifier">BOOST_AUTO_TEST_SUITE</span><span class="special">(</span><span class="identifier">suite1</span><span class="special">,</span> <span class="special">*</span> <span class="identifier">utf</span><span class="special">::</span><span class="identifier">label</span><span class="special">(</span><span class="string">"simple"</span><span class="special">))</span>
    126. 

  126. 

  127.   <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span><span class="identifier">test_case2</span><span class="special">)</span>
    128. 

  128.   <span class="special">{</span>
    129. 

  129.     <span class="identifier">BOOST_TEST</span><span class="special">(</span><span class="keyword">true</span><span class="special">);</span>
    130. 

  130.   <span class="special">}</span>
    131. 

  131. 

  132. <span class="identifier">BOOST_AUTO_TEST_SUITE_END</span><span class="special">()</span>
    133. 

  133. 

  134. <span class="identifier">BOOST_AUTO_TEST_SUITE</span><span class="special">(</span><span class="identifier">suite1</span><span class="special">)</span>
    135. 

  135. 

  136.   <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span><span class="identifier">test_case3</span><span class="special">)</span>
    137. 

  137.   <span class="special">{</span>
    138. 

  138.     <span class="identifier">BOOST_TEST</span><span class="special">(</span><span class="keyword">true</span><span class="special">);</span>
    139. 

  139.   <span class="special">}</span>
    140. 

  140. 

  141. <span class="identifier">BOOST_AUTO_TEST_SUITE_END</span><span class="special">()</span>
    142. 

  142. </pre>
    143. 

  143.                 </td></tr></tbody>
    144. 

  144. </table></div>
    145. 

  145. <div class="informaltable"><table class="table">
    146. 

  146. <colgroup><col></colgroup>
    147. 

  147. <thead><tr><th>
    148. 

  148.                   <p>
    149. 

  149.                     Output
    150. 

  150.                   </p>
    151. 

  151.                 </th></tr></thead>
    152. 

  152. <tbody><tr><td>
    153. 

  153. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="special">&gt;</span> <span class="identifier">decorator_03</span> <span class="special">--</span><span class="identifier">run_test</span><span class="special">=</span><span class="error">@</span><span class="identifier">trivial</span>
    154. 

  154. <span class="identifier">Running</span> <span class="number">3</span> <span class="identifier">test</span> <span class="identifier">cases</span><span class="special">...</span>
    155. 

  155. 

  156. <span class="special">***</span> <span class="identifier">No</span> <span class="identifier">errors</span> <span class="identifier">detected</span>
    157. 

  157. 

  158. 

  159. <span class="special">&gt;</span> <span class="identifier">decorator_03</span> <span class="special">--</span><span class="identifier">run_test</span><span class="special">=</span><span class="error">@</span><span class="identifier">simple</span>
    160. 

  160. <span class="identifier">Running</span> <span class="number">3</span> <span class="identifier">test</span> <span class="identifier">cases</span><span class="special">...</span>
    161. 

  161. 

  162. <span class="special">***</span> <span class="identifier">No</span> <span class="identifier">errors</span> <span class="identifier">detected</span>
    163. 

  163. </pre>
    164. 

  164.                 </td></tr></tbody>
    165. 

  165. </table></div>
    166. 

  166. <p>
    167. 

  167.           In the above example, the scope of test suite <code class="computeroutput"><span class="identifier">suite1</span></code>
    168. 

  168.           is opened three times. This results in a test suite containing three test
    169. 

  169.           cases and associated with two <a class="link" href="../../utf_reference/test_org_reference/decorator_label.html" title="label (decorator)"><code class="computeroutput"><span class="identifier">label</span></code></a> decorators. Therefore running
    170. 

  170.           tests by label <code class="computeroutput"><span class="string">"trivial"</span></code>
    171. 

  171.           as well as by label <code class="computeroutput"><span class="string">"simple"</span></code>
    172. 

  172.           both result in executing all three test cases from the suite.
    173. 

  173.         </p>
    174. 

  174. <div class="caution"><table border="0" summary="Caution">
    175. 

  175. <tr>
    176. 

  176. <td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../../../../../../doc/src/images/caution.png"></td>
    177. 

  177. <th align="left">Caution</th>
    178. 

  178. </tr>
    179. 

  179. <tr><td align="left" valign="top"><p>
    180. 

  180.             The above syntax for decorators requires that the compiler supports variadic
    181. 

  181.             macros (added in C++11). If you intend for your test program to also
    182. 

  182.             work for compilers without variadic macros, use explicit decorator syntax,
    183. 

  183.             described below.
    184. 

  184.           </p></td></tr>
    185. 

  185. </table></div>
    186. 

  186. </div>
    187. 

  187. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
    188. 

  188. <td align="left"></td>
    189. 

  189. <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
    190. 

  190.       contributors<p>
    191. 

  191.         Distributed under the Boost Software License, Version 1.0. (See accompanying
    192. 

  192.         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>)
    193. 

  193.       </p>
    194. 

  194. </div></td>
    195. 

  195. </tr></table>
    196. 

  196. <hr>
    197. 

  197. <div class="spirit-nav">
    198. 

  198. <a accesskey="p" href="../decorators.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../decorators.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="explicit_decorator_declaration.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
    199. 

  199. </div>
    200. 

  200. </body>
    201. 

  201. </html>
    202.