robotframework笔记26

测试数据文档工具(Testdoc)

Testdoc是机器人框架内置的工具生成高水平 根据测试用例文档。 创建的文档是在HTML中 格式和它包括名称、文档和其他元数据 测试套件和测试用例,以及和他们的顶级关键词 参数。

一般使用

简介

python -m robot.testdoc [options] data_sources output_file

选项

<标题>
	生成的文档的标题。 标题中强调转换为空间。 默认的标题是顶级套件的名称。
<名称>
	覆盖顶级测试套件的名称。
<文件>
	覆盖顶层的文档测试套件。
<名称:值>
	释放/覆盖顶级测试套件的元数据。
<标记>
	设置给定的标记(s)所有测试用例。
<名称>
	包括测试的名字。
<名称>
	包括套件的名字。
<标记>
	包括测试的标签。
<标记>
	排除测试的标签。
——帮助	在控制台打印此帮助。

。

生成文档

数据可以作为一个单独的文件,目录,或者是多个文件 目录。 在所有这些情况下,最后一个参数必须的文件 写输出。

。

例子:

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

测试数据清理工具(整洁)

• 5.3.1一般使用
• 5.3.2清理测试数据
• 5.3.3改变测试数据格式

整洁是机器人框架内置的清理和变化的工具 机器人框架测试数据文件的格式。

选项。

一般使用

剧情简介

python -m robot.tidy [options] inputfile
python -m robot.tidy [options] inputfile [outputfile]
python -m robot.tidy --inplace [options] inputfile [more input files]
python -m robot.tidy --recursive [options] directory

选项

——原地	整洁的给定文件),这样原始文件被覆盖 (或删除,如果格式改变)。 当这个选项 使用,它可以给多个输入文件。 例子: python -m robot.tidy --inplace tests.html python -m robot.tidy --inplace --format txt *.html
——递归
	选择使用。
html <机器人| txt | | tsv >
	输出文件格式。 如果显式给定的输出文件, 默认值为从其扩展。 否则 格式是没有改变。
——用管道
	使用管道字符(|)作为细胞分离器txt格式。
<数>
	细胞之间的空间txt格式的数量。 2.7.3新机器人框架。
<本机windows | | unix >
	行分隔符用于输出。 默认值是“本地”。 本机 :使用操作系统的本机行分隔符 窗户 :使用Windows行分隔符(CRLF) unix :使用Unix行分隔符(低频) 新机器人2.7.6框架。
——帮助	显示帮助。

选择执行

),但它也可以运行 一个脚本:

python path/robot/tidy.py [options] arguments

与源代码目录 在您的系统。

输出编码

所有输出文件编写使用utf - 8编码。 输出写入到 控制台使用当前控制台编码。

清理测试数据

测试用例文件创建HTML编辑器或手写可以规范化 使用整洁。 整洁总是写标题一致,一致的订单 设置,和一致的细胞和表之间的空白。

例子:

python -m robot.tidy messed_up_tests.html cleaned_tests.html
python -m robot.tidy --inplace tests.txt

改变测试数据格式

的选项,默认值是得到了扩展 可能的输出文件。

例子:

python -m robot.tidy tests.html tests.txt
python -m robot.tidy --format txt --inplace tests.html
python -m robot.tidy --format tsv --recursive mytests

外部工具

,为各种ide和扩展 文本编辑器插件,持续集成系统和构建工具, 等等。

。

请注意

一些支持工具使用与机器人分布式框架 本身。 现在所有这些工具也可单独购买, 他们从存储库中删除和源分布 在机器人2.8.6框架。

测试数据中所有可用的设置

• 但是设置表
• 6.1.2测试用例表
• 6.1.3关键字表

但是设置表

设置表是用于导入测试库,文件和资源 变量定义元数据的文件和测试套件和测试 用例。 它可以包括在测试用例文件和资源文件。 请注意 在一个资源文件,设置表只能包括设置 导入库、资源和变量。

设置可以设置表中

的名字	描述
图书馆	。
资源	。
变量	。
文档	文档。
元数据	。
套件设置	。
套件拆卸	。
力的标签	。
默认的标签	。
测试设置	。
测试拆卸	。
测试模板	测试用例。
测试超时	。

请注意

。 这可以简化设置读取 尤其是当使用纯文本格式。

测试用例表

设置测试用例表中总是具体的测试 定义它们。 覆盖这些设置 表中定义的默认值设置。

设置测试用例表中可用

的名字	描述
(文档)	。
(标签)	。
(设置)	。
(拆卸)	。
(模板)	。
(超时)	。

关键字表

设置关键字表中的特定于用户的关键字 定义它们。

设置关键字表中可用

的名字	描述
(文档)	。
(标签)	。
(参数)	。
(返回)	。
(拆卸)	。
(超时)	。

所有的命令行选项

。 环境变量影响执行和后期处理 列出。

• 6.2.1测试执行的命令行选项
• 6.2.2后处理输出的命令行选项
• 6.2.3环境变量为执行和后期处理

测试执行的命令行选项

<名称>
	顶级的测试套件。
<文件>
	顶级的测试套件。
<名称:值>
	顶级测试套件。
<标记>
	执行测试用例。
<名称>
	。
<名称>
	的名字。
<文件>
	可重复。
<文件>
	代替。
<标记>
	通过标签。
<标记>
	通过标签。
<标记>
	。
<标记>
	。
<名称:值>
	。
<路径:参数>
	。
< dir >
	。
<文件>
	。
<文件>
	。
<文件>
	。
<文件>
	。
——xunitskipnoncritical
	跳过。
<文件>
	这是在执行期间写的。
——timestampoutputs
	所有输出文件。
——splitlog	成小块,开放 浏览器透明。
<标题>
	对生成的测试日志。
<标题>
	对生成的测试报告。
<色调>
	生成的报告。
<上>
	可以给 分离一个冒号(:)。
<上>
	表中输出。
<标记>
	表。
<标记>
	表。
<标签:标题>
	。
<模式:医生>
	。
<模式:链接:标题>
	表。
< | |通过名字:模式|标签:模式| | wuks >
	从生成的日志文件。
<为| foritem |名称:模式|标签:模式>
	在生成的日志文件。
<名称:参数>
	测试执行监控。
——warnonskippedfiles
	。
——nostatusrc	为零,不管失败 在测试用例。 错误代码返回正常。
——runemptysuite
	。
——dryrun	没有执行模式运行测试 关键字源自测试库。 有用的 验证测试数据的语法。
——exitonfailure
	如果任何关键的测试失败。
——exitonerror	如果任何错误发生在解析测试数据,导入库,等等。
——skipteardownonexit
	测试执行是过早地停止了。
<名称:参数>
	。
<名称:参数>
	。
< | | |套件测试都没有>
	测试执行的顺序。
<详细|虚线| |安静没有>
	。
——点缀	。
——安静	。
<宽度>
	的控制台输出。
<汽车| | ansi |关闭>
	在控制台上使用。
<汽车| |关闭>
	当顶层 关键字在一个测试用例结束。
<路径>
	。
<什么:>
	有问题的在控制台。
<路径>
	从。
——帮助	。
——版本	。

6.2.2后处理输出的命令行选项

——合并	。
——rerunmerge	代替。
<名称>
	顶级的测试套件。
<文件>
	顶级的测试套件。
<名称:值>
	顶级测试套件。
<标记>
	所有处理测试用例。
<名称>
	。
<名称>
	的名字。
<标记>
	通过标签。
<标记>
	通过标签。
<标记>
	。
<标记>
	。
< dir >
	。
<文件>
	。
<文件>
	。
<文件>
	。
<文件>
	。
——xunitskipnoncritical
	跳过。
——timestampoutputs
	所有输出文件。
——splitlog	成小块,开放 浏览器透明。
<标题>
	对生成的测试日志。
<标题>
	对生成的测试报告。
<色调>
	生成的报告。
<上>
	可以给 分离一个冒号(:)。
<上>
	表中输出。
<标记>
	表。
<标记>
	表。
<标签:标题>
	。
<模式:医生>
	。
<模式:链接:标题>
	表。
< | |通过名字:模式|标签:模式| | wuks >
	从生成的输出。
<为| foritem |名称:模式|标签:模式>
	在生成的输出。
<时间>
	当创建的测试执行 报告。
<时间>
	当创建的测试执行报告。
——nostatusrc	为零,不管失败 在测试用例。 错误代码返回正常。
——processemptysuite
	。
<名称:参数>
	。
<汽车| | ansi |关闭>
	在控制台上使用。
<路径>
	。
<什么:>
	有问题的在控制台。
<路径>
	从。
——帮助	。
——版本	。

环境变量为执行和后期处理

ROBOT_OPTIONS REBOT_OPTIONS

在命令行上。

ROBOT_SYSLOG_FILE

文件,机器人框架内部写道 解析信息测试用例文件和运行 测试。

ROBOT_SYSLOG_LEVEL

文件。

ROBOT_INTERNAL_TRACES

。

测试数据模板

。

因为 它需要样板太少,模板不会是非常有用的。

testcase_template.html

测试用例文件模板的HTML格式。

testcase_template.tsv

测试用例文件模板TSV格式。

resource_template.html

资源文件模板的HTML格式。

resource_template.tsv

资源文件TSV格式的模板。

attd_template.html

在验收测试驱动创建测试用例的模板 开发(ATDD)风格。 这些测试是由高层 关键字不需要参数和模板 相应的简化。

。