测试数据文档工具(Testdoc)¶
Testdoc是Robot Framework内置的工具, 用于从测试用例生成HTML文档. 生成的文档包含名称, 每个测试套件和测试用例的文档和元数据, 以及顶层关键字和它们的参数.
用法¶
总览¶
python -m robot.testdoc [options] data_sources output_file
选项¶
-T, --title <title> Set the title of the generated documentation. Underscores in the title are converted to spaces. The default title is the name of the top level suite. -N, --name <name> Override the name of the top level test suite. -D, --doc <doc> Override the documentation of the top level test suite. -M, --metadata <name:value> Set/override free metadata of the top level test suite. -G, --settag <tag> Set given tag(s) to all test cases. -t, --test <name> Include tests by name. -s, --suite <name> Include suites by name. -i, --include <tag> Include tests by tags. -e, --exclude <tag> Exclude tests by tags. -h, --help Print this help in the console.
除了 --title
以外的所有选项的语义都和在 执行测试用例 时使用完全一样.
生成文档¶
生成文档的数据源可以是单个文件, 单个目录, 也可以是多个文件和目录. 所有这些情况, 最后那个参数都必须是最终文档输出要写入的文件.
Testdoc适用于Robot Framework支持的所有解释器(Python, Jython and IronPython). 它可以以python模块的方式执行, 如 python -m robot.testdoc
, 也可以当作一个脚本来执行, 例如: python path/robot/testdoc.py
.
示例:
python -m robot.testdoc my_test.html testdoc.html
jython -m robot.testdoc --name smoke_tests --include smoke path/to/my_tests smoke.html
ipy path/to/robot/testdoc.py first_suite.txt second_suite.txt output.html