log_junit_format.html 5.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  4. <title>JUNIT log format</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="../log_formats.html" title="Log formats">
  9. <link rel="prev" href="log_xml_format.html" title="XML log format">
  10. <link rel="next" href="../report_formats.html" title="Report formats">
  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="log_xml_format.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../log_formats.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="../report_formats.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
  24. </div>
  25. <div class="section">
  26. <div class="titlepage"><div><div><h4 class="title">
  27. <a name="boost_test.test_output.log_formats.log_junit_format"></a><a class="link" href="log_junit_format.html" title="JUNIT log format">JUNIT
  28. log format</a>
  29. </h4></div></div></div>
  30. <p>
  31. The <a href="http://junit.org/" target="_top">JUNIT format</a> is log format supported
  32. by a wide range of Continuous Build/Integration tools.
  33. </p>
  34. <p>
  35. This format defaults its log level to <a class="link" href="test_log_output.html#test_log_output_table"><code class="computeroutput"><span class="identifier">General</span> <span class="identifier">information</span></code></a>
  36. and its default stream to a file named after <a class="link" href="../../tests_organization/test_tree/master_test_suite.html" title="Master test suite">master
  37. test suite</a>. The logger will attempt to not overwrite any existing
  38. output file, which is also usually understood by Continuous Build tools.
  39. </p>
  40. <p>
  41. This format is in fact both a log and a report format: most of the Continuous
  42. Build tools will summarize the content of a JUNIT file and show an overview
  43. of the failing/succeeding tests of a module (report format) while letting
  44. the user inspect the detailed logs (log format).
  45. </p>
  46. <div class="caution"><table border="0" summary="Caution">
  47. <tr>
  48. <td rowspan="2" align="center" valign="top" width="25"><img alt="[Caution]" src="../../../../../../../doc/src/images/caution.png"></td>
  49. <th align="left">Caution</th>
  50. </tr>
  51. <tr><td align="left" valign="top"><p>
  52. The minimal log-level for the JUnit logger is <a class="link" href="test_log_output.html#test_log_output_table"><code class="computeroutput"><span class="identifier">non</span> <span class="identifier">fatal</span>
  53. <span class="identifier">error</span></code></a>. Any set-up to
  54. higher log level will default to that minimal log-level.
  55. </p></td></tr>
  56. </table></div>
  57. <div class="note"><table border="0" summary="Note">
  58. <tr>
  59. <td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../../../doc/src/images/note.png"></td>
  60. <th align="left">Note</th>
  61. </tr>
  62. <tr><td align="left" valign="top"><p>
  63. Until Boost 1.64, the log level was previously defaulting to <code class="computeroutput"><span class="identifier">success</span></code> and was causing a heavy load
  64. on the logging part in some circumstances.
  65. </p></td></tr>
  66. </table></div>
  67. </div>
  68. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  69. <td align="left"></td>
  70. <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
  71. contributors<p>
  72. Distributed under the Boost Software License, Version 1.0. (See accompanying
  73. 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>)
  74. </p>
  75. </div></td>
  76. </tr></table>
  77. <hr>
  78. <div class="spirit-nav">
  79. <a accesskey="p" href="log_xml_format.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../log_formats.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="../report_formats.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
  80. </div>
  81. </body>
  82. </html>