我有 Hudson 作为持续集成服务器，我想使用“发布 JUnit 测试结果报告”选项。但是我不使用 xUnit 工具进行测试，而是使用 shell 脚本运行测试并以简单格式返回结果。我正在考虑制作一个将这些结果转换为 JUnit 格式的脚本。所以我对 JUnit 文件的外观很感兴趣？
问问题
245557 次
8 回答
135
几个月前我做过类似的事情，结果证明这种简单的格式足以让 Hudson 接受它作为测试协议：
<testsuite tests="3">
<testcase classname="foo1" name="ASuccessfulTest"/>
<testcase classname="foo2" name="AnotherSuccessfulTest"/>
<testcase classname="foo3" name="AFailingTest">
<failure type="NotEnoughFoo"> details about failure </failure>
</testcase>
</testsuite>
这个问题有更详细的答案：Spec。用于 JUnit XML 输出
于 2011-02-07T19:56:42.640 回答
96
我刚刚抓取了其他人已链接到的junit-4.xsd，并使用名为XMLSpear的工具将架构转换为空白 XML 文件，其选项如下所示。这是（稍微清理一下）结果：
<?xml version="1.0" encoding="UTF-8"?>
<testsuites disabled="" errors="" failures="" name="" tests="" time="">
<testsuite disabled="" errors="" failures="" hostname="" id=""
name="" package="" skipped="" tests="" time="" timestamp="">
<properties>
<property name="" value=""/>
</properties>
<testcase assertions="" classname="" name="" status="" time="">
<skipped/>
<error message="" type=""/>
<failure message="" type=""/>
<system-out/>
<system-err/>
</testcase>
<system-out/>
<system-err/>
</testsuite>
</testsuites>
其中一些项目可能会多次出现：
- 只能有一个
testsuites元素，因为这就是 XML 的工作方式，但testsuite元素中可以有多个元素testsuites。 - 每个
properties元素可以有多个子元素property。 - 每个
testsuite元素可以有多个子元素testcase。 - 每个
testcase元素可以有多个error、failure、system-out或system-err子元素。
于 2012-03-13T19:57:22.420 回答
58
Anders Lindahl问题的最佳答案是指xsd 文件。
就我个人而言，我发现这个 xsd 文件也非常有用（我不记得我是如何找到那个的）。它看起来不那么令人生畏，而且就我使用它而言，所有元素和属性似乎都被 Jenkins 识别（v1.451）
但有一件事：当添加多个<failure ...元素时，Jenkins 中只保留了一个。创建 xml 文件时，我现在将所有失败合并为一个。
2016 年 11 月更新该链接现在已断开。一个更好的选择是来自cubic.org 的这个页面：JUnit XML 报告文件格式，其中已经做出了很好的努力来提供一个合理的文档示例。下面复制了示例和 xsd，但它们的页面看起来更好。
示例 JUnit XML 文件
<?xml version="1.0" encoding="UTF-8"?>
<!-- a description of the JUnit XML format and how Jenkins parses it. See also junit.xsd -->
<!-- if only a single testsuite element is present, the testsuites
element can be omitted. All attributes are optional. -->
<testsuites disabled="" <!-- total number of disabled tests from all testsuites. -->
errors="" <!-- total number of tests with error result from all testsuites. -->
failures="" <!-- total number of failed tests from all testsuites. -->
name=""
tests="" <!-- total number of successful tests from all testsuites. -->
time="" <!-- time in seconds to execute all test suites. -->
>
<!-- testsuite can appear multiple times, if contained in a testsuites element.
It can also be the root element. -->
<testsuite name="" <!-- Full (class) name of the test for non-aggregated testsuite documents.
Class name without the package for aggregated testsuites documents. Required -->
tests="" <!-- The total number of tests in the suite, required. -->
disabled="" <!-- the total number of disabled tests in the suite. optional -->
errors="" <!-- The total number of tests in the suite that errored. An errored test is one that had an unanticipated problem,
for example an unchecked throwable; or a problem with the implementation of the test. optional -->
failures="" <!-- The total number of tests in the suite that failed. A failure is a test which the code has explicitly failed
by using the mechanisms for that purpose. e.g., via an assertEquals. optional -->
hostname="" <!-- Host on which the tests were executed. 'localhost' should be used if the hostname cannot be determined. optional -->
id="" <!-- Starts at 0 for the first testsuite and is incremented by 1 for each following testsuite -->
package="" <!-- Derived from testsuite/@name in the non-aggregated documents. optional -->
skipped="" <!-- The total number of skipped tests. optional -->
time="" <!-- Time taken (in seconds) to execute the tests in the suite. optional -->
timestamp="" <!-- when the test was executed in ISO 8601 format (2014-01-21T16:17:18). Timezone may not be specified. optional -->
>
<!-- Properties (e.g., environment settings) set during test
execution. The properties element can appear 0 or once. -->
<properties>
<!-- property can appear multiple times. The name and value attributres are required. -->
<property name="" value=""/>
</properties>
<!-- testcase can appear multiple times, see /testsuites/testsuite@tests -->
<testcase name="" <!-- Name of the test method, required. -->
assertions="" <!-- number of assertions in the test case. optional -->
classname="" <!-- Full class name for the class the test method is in. required -->
status=""
time="" <!-- Time taken (in seconds) to execute the test. optional -->
>
<!-- If the test was not executed or failed, you can specify one
the skipped, error or failure elements. -->
<!-- skipped can appear 0 or once. optional -->
<skipped/>
<!-- Indicates that the test errored. An errored test is one
that had an unanticipated problem. For example an unchecked
throwable or a problem with the implementation of the
test. Contains as a text node relevant data for the error,
for example a stack trace. optional -->
<error message="" <!-- The error message. e.g., if a java exception is thrown, the return value of getMessage() -->
type="" <!-- The type of error that occured. e.g., if a java execption is thrown the full class name of the exception. -->
></error>
<!-- Indicates that the test failed. A failure is a test which
the code has explicitly failed by using the mechanisms for
that purpose. For example via an assertEquals. Contains as
a text node relevant data for the failure, e.g., a stack
trace. optional -->
<failure message="" <!-- The message specified in the assert. -->
type="" <!-- The type of the assert. -->
></failure>
<!-- Data that was written to standard out while the test was executed. optional -->
<system-out></system-out>
<!-- Data that was written to standard error while the test was executed. optional -->
<system-err></system-err>
</testcase>
<!-- Data that was written to standard out while the test suite was executed. optional -->
<system-out></system-out>
<!-- Data that was written to standard error while the test suite was executed. optional -->
<system-err></system-err>
</testsuite>
</testsuites>
JUnit XSD 文件
<?xml version="1.0" encoding="UTF-8" ?>
<!-- from https://svn.jenkins-ci.org/trunk/hudson/dtkit/dtkit-format/dtkit-junit-model/src/main/resources/com/thalesgroup/dtkit/junit/model/xsd/junit-4.xsd -->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="failure">
<xs:complexType mixed="true">
<xs:attribute name="type" type="xs:string" use="optional"/>
<xs:attribute name="message" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="error">
<xs:complexType mixed="true">
<xs:attribute name="type" type="xs:string" use="optional"/>
<xs:attribute name="message" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="properties">
<xs:complexType>
<xs:sequence>
<xs:element ref="property" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="property">
<xs:complexType>
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="value" type="xs:string" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="skipped" type="xs:string"/>
<xs:element name="system-err" type="xs:string"/>
<xs:element name="system-out" type="xs:string"/>
<xs:element name="testcase">
<xs:complexType>
<xs:sequence>
<xs:element ref="skipped" minOccurs="0" maxOccurs="1"/>
<xs:element ref="error" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="failure" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="system-out" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="system-err" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="assertions" type="xs:string" use="optional"/>
<xs:attribute name="time" type="xs:string" use="optional"/>
<xs:attribute name="classname" type="xs:string" use="optional"/>
<xs:attribute name="status" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="testsuite">
<xs:complexType>
<xs:sequence>
<xs:element ref="properties" minOccurs="0" maxOccurs="1"/>
<xs:element ref="testcase" minOccurs="0" maxOccurs="unbounded"/>
<xs:element ref="system-out" minOccurs="0" maxOccurs="1"/>
<xs:element ref="system-err" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="required"/>
<xs:attribute name="tests" type="xs:string" use="required"/>
<xs:attribute name="failures" type="xs:string" use="optional"/>
<xs:attribute name="errors" type="xs:string" use="optional"/>
<xs:attribute name="time" type="xs:string" use="optional"/>
<xs:attribute name="disabled" type="xs:string" use="optional"/>
<xs:attribute name="skipped" type="xs:string" use="optional"/>
<xs:attribute name="timestamp" type="xs:string" use="optional"/>
<xs:attribute name="hostname" type="xs:string" use="optional"/>
<xs:attribute name="id" type="xs:string" use="optional"/>
<xs:attribute name="package" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="testsuites">
<xs:complexType>
<xs:sequence>
<xs:element ref="testsuite" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
<xs:attribute name="name" type="xs:string" use="optional"/>
<xs:attribute name="time" type="xs:string" use="optional"/>
<xs:attribute name="tests" type="xs:string" use="optional"/>
<xs:attribute name="failures" type="xs:string" use="optional"/>
<xs:attribute name="disabled" type="xs:string" use="optional"/>
<xs:attribute name="errors" type="xs:string" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>
于 2012-02-23T09:31:51.037 回答
27
我找不到任何关于此的好的信息，所以我做了一些试验和错误。Jenkins (v1.585) 可以识别以下属性和字段（并且只有这些）。
<?xml version="1.0" encoding="UTF-8"?>
<testsuite>
<!-- if your classname does not include a dot, the package defaults to "(root)" -->
<testcase name="my testcase" classname="my package.my classname" time="29">
<!-- If the test didn't pass, specify ONE of the following 3 cases -->
<!-- option 1 --> <skipped />
<!-- option 2 --> <failure message="my failure message">my stack trace</failure>
<!-- option 3 --> <error message="my error message">my crash report</error>
<system-out>my STDOUT dump</system-out>
<system-err>my STDERR dump</system-err>
</testcase>
</testsuite>
（我从这个示例 XML 文档开始，然后从那里向后工作。）
于 2014-10-30T19:11:08.343 回答
8
我决定发布一个新的答案，因为一些现有的答案已经过时或不完整。
首先：没有什么像JUnit XML Format Specification，因为 JUnit 不生成任何类型的 XML 或 HTML 报告。
XML 报告生成本身来自 Ant JUnit 任务/Maven Surefire 插件/Gradle（无论您使用哪个来运行测试）。XML 报告格式首先由 Ant 引入，后来被 Maven（和 Gradle）改编。
如果有人只需要官方的 XML 格式，那么：
- 有一个 maven surefire 生成的 XML 报告的模式，可以在这里找到：surefire-test-report.xsd。
- 对于 ant 生成的 XML，这里有一个 3rd 方模式可用（但它可能有点过时）。
希望它会帮助某人。
于 2016-11-22T14:08:03.647 回答
6
基本结构 这是一个 JUnit 输出文件的示例，显示了一个跳过和失败的结果，以及一个通过的结果。
<?xml version="1.0" encoding="UTF-8"?>
<testsuites>
<testsuite name="JUnitXmlReporter" errors="0" tests="0" failures="0" time="0" timestamp="2013-05-24T10:23:58" />
<testsuite name="JUnitXmlReporter.constructor" errors="0" skipped="1" tests="3" failures="1" time="0.006" timestamp="2013-05-24T10:23:58">
<properties>
<property name="java.vendor" value="Sun Microsystems Inc." />
<property name="compiler.debug" value="on" />
<property name="project.jdk.classpath" value="jdk.classpath.1.6" />
</properties>
<testcase classname="JUnitXmlReporter.constructor" name="should default path to an empty string" time="0.006">
<failure message="test failure">Assertion failed</failure>
</testcase>
<testcase classname="JUnitXmlReporter.constructor" name="should default consolidate to true" time="0">
<skipped />
</testcase>
<testcase classname="JUnitXmlReporter.constructor" name="should default useDotNotation to true" time="0" />
</testsuite>
</testsuites>
以下是典型 JUnit XML 报告的文档结构。请注意，报告可以包含 1 个或多个测试套件。每个测试套件都有一组属性（记录环境信息）。每个测试套件还包含 1 个或多个测试用例，如果测试未通过，每个测试用例将包含跳过、失败或错误节点。如果测试用例通过了，那么它将不包含任何节点。有关哪些属性对每个节点有效的更多详细信息，请参阅以下“模式”部分。
<testsuites> => the aggregated result of all junit testfiles
<testsuite> => the output from a single TestSuite
<properties> => the defined properties at test execution
<property> => name/value pair for a single property
...
</properties>
<error></error> => optional information, in place of a test case - normally if the tests in the suite could not be found etc.
<testcase> => the results from executing a test method
<system-out> => data written to System.out during the test run
<system-err> => data written to System.err during the test run
<skipped/> => test was skipped
<failure> => test failed
<error> => test encountered an error
</testcase>
...
</testsuite>
...
</testsuites>
于 2016-05-09T04:13:51.067 回答
4
“JUnit”和“xUnit”结果有多种模式。
- Apache Ant 的 JUnit 输出的 XSD 可以在以下位置找到：https ://github.com/windyroad/JUnit-Schema （归功于这个答案：https ://stackoverflow.com/a/4926073/1733117 ）
- 来自 Jenkins xunit-plugin 的 XSD 可以在以下位置找到：https ://github.com/jenkinsci/xunit-plugin/tree/master/src/main/resources/org/jenkinsci/plugins/xunit/types （下
model/xsd）
请注意，Jenkins xunit-plugin 使用了多个版本的模式（当前最新版本junit-10.xsd增加了对 Erlang/OTP Junit 格式的支持）。
一些测试框架以及“xUnit”风格的报告插件也使用他们自己的秘诀来生成“xUnit”风格的报告，那些可能不使用特定的模式（请阅读：他们尝试但这些工具可能无法针对任何一个模式）。Jenkins 中的 Python 单元测试？给出了其中几个库的快速比较以及生成的 xml 报告之间的细微差别。
于 2016-03-02T03:53:34.227 回答
2
关于使用 python 的好答案：（有很多方法可以做到） Jenkins 中的 Python 单元测试？
恕我直言，最好的方法是编写 python unittest 测试并安装 pytest（类似于'yum install pytest'）来安装 py.test。然后像这样运行测试： 'py.test --junitxml results.xml test.py'。您可以运行任何 unittest python 脚本并获取 jUnit xml 结果。
https://docs.python.org/2.7/library/unittest.html
在 jenkins 构建配置 构建后操作 使用 result.xml 和您生成的任何更多测试结果文件添加“发布 JUnit 测试结果报告”操作。
于 2016-05-06T12:00:01.643 回答