用于将xUnit/JUnit XML格式转换为具有可跟踪项的structuredText(.rst)的Python脚本
mlx.xunit2rst的Python项目详细描述
文件xunit2rst
可跟踪的文件(.xUnitExt)可以用JUnitExt转换成xml文件(.xUnitExt)。在
内容
Goal
此脚本允许您通过mlx.traceabilitySphinx扩展将测试报告连接到测试用例。在
Installation
pip3 install mlx.xunit2rst
Usage
^{pr2}$Behavior
Itemization
默认情况下,输入文件中的所有testcase元素都用于创建可靠性项。这可能并不总是如此 渴望的。-s,--itemize-suites标志允许脚本逐项列出testsuite元素。在这种情况下 testcase元素仍将被解析,以确定testsuite是通过还是失败。在
Item IDs
要逐项化的元素的name属性用于构建项ID 大写,空格被转换成下划线,&;字符被转换成和。有效的前缀必须 以脚本识别的连字符结尾。如果在该名称前面附加了一个字符串 dot,这个字符串不会被考虑在内。示例如下:
MY_LIB.ITEST_MY_LIB-my function & keywordXML元素名产生项ID ITEST_MY_LIB-MY_FUNCTION_AND_KEYWORD
Prefix
可追溯性项ID具有其所属组的唯一前缀,例如ITEST_MY_LIB-。--prefix 输入参数允许您配置此前缀。它将被添加到要生成的输入文件中找到的项名称之前 项ID。默认情况下,脚本为集成或单元测试报告添加ITEST-或UTEST-,除非前缀 已存在于输入文件中。在
Distinction Between Unit and Integration Test Reports
在XML中具有testsuites元素作为根的测试报告被视为单元测试报告。否则脚本 将输入文件视为集成测试报告。当在中找到前缀时,此识别行为将被覆盖 使用输入文件或--prefixinput参数。脚本查找U或I作为 前缀。最后,可以通过使用--unit-or-integrationinput参数显式定义类型。 它的值应该以u或i开头,并且不区分大小写进行解析。在
Include Message of Failure(s)
当设置-f,--failure-message标志时,该工具将包含该项测试用例的所有失败消息 在它的身体里。在
Link to Log File
使用输入参数-l,--log PATH_TO_FILE添加指向HTML日志文件的链接。路径应该是相对的 Sphinx输出此工具生成的RST文件的HTML版本的位置。一定要把这个日志文件 并将其添加到您的^{em1}中的html_extra_path$配置文件。这样,日志文件将以 Sphinx输出位置的根。在
- 项目
标签: