robot framework - robot命令参数解析

原创
2018/01/16 15:50
阅读数 2K

robot 命令参数解析

version > 3.0.1

原文档查看命令:

robot --help

robot -h

-F --extension value

通过文件扩展名控制需要执行的用例。如果只执行一个文件,这个参数无效。需要执行多个扩展名时,用“:”分隔开。

Examples: 
--extension robot
-F robot:txt

-N --name name

设置测试套件的名称。如果包含“_”显示为空格。默认值为脚本所在目录的名称。不影响测试的执行过程。

Examples: 
--name Regression_Test
-N Smoke

-D --doc documentation

设置整体测试报告的文档。如果包含“_”显示为空格。支持简单的html格式。不影响测试的执行过程。

Examples: 
***bold***
http://url/

-M --metadata name:value

设置整体测试报告的数据信息,会显示在测试报告中。不影响测试的执行过程。

Examples: 
--metadata version:1.2
--M version:1.2

-G --settag tag *

设置全局标签

Examples: 
--settag tag1
--G tag2

-t --test name *

通过测试用名称控制执行范围

Examples: 
--test casename1
-t testname2

-s --suite name *

通过测试套件名称控制测试执行范围

Examples: 
--suite parentname.childname
-s suitename

-i --include tag *

通过标签控制测试执行范围,可以使用AND, OR, and NOT 操作符

Examples: 
--include foo --include bar*
--include fooANDbar*

-e --exclude tag *

通过标签控制测试不执行范围

Examples: 
--exclude tag1
-e tag2

-R --rerunfailed output

重新执行一个更早的output文件中的Fail的测试用例

Examples: 
--rerunfailed output.xml
-R output.xml

-S --rerunfailedsuites output

重新执行一个更早的output文件中的Fail的Testsuite中的测试用例

Examples: 
--rerunfailedsuites output.xml
-S output.xml

-c --critical tag *

设置重要标签的范围

Examples: 
--critical tag1
-c tag2

-n --noncritical tag *

设置不重要标签的范围

Examples: 
--noncritical tag1
-n tag2

-v --variable name:value *

添加参数

Examples: 
--variable str:Hello =>${str} = `Hello`
-v hi:Hi_World -E space:_=>${hi} = `Hi World`
-v x: -v y:42=>${x} = ``, ${y} = `42`

-V --variablefile path *

添加参数文件

Examples: 
--variablefile path/vars.yaml
--variablefile environment.py:testing

-d --outputdir dir

测试结果输出文件夹

Examples: 
--outputdir result/
-d result/

-o --output file

测试结果数据文件名 Default: output.xml

Examples: 
--output output.xml
-o out.xml

-l --log file

测试log文件名,可以通过None值禁用测试日志功能

Examples: 
--log mylog.html
-l NONE

-r --report file

测试报告文件名,可以通过None值禁用测试报告功能

Examples: 
--report myreport.html
-r NONE

-x --xunit file

兼容xUnit的报告,默认不创建

Examples: 
--xunit myxunit1.xml
-x myxunit2.xml

--xunitskipnoncritical

在Xunit报告中标记不重要的测试

-T --timestampoutputs

创建带时间戳的报告文件 output-20070503-154410.xml,report-20070503-154410.html

Examples: 
-T -o output.xml -r report.html -l none

--splitlog

把日志文件拆分成很多小的js文件

--logtitle title

设置显示在日志中的名称,“_”转化为空格“ ”

--reporttitle title

设置显示在测试报告中的名称,“_”转化为空格“ ”

--reportbackground colors

设置测试报告背景颜色

Examples: 
--reportbackground green:yellow:red
--reportbackground #00E:#E00

-L --loglevel level

设置日志等级,可用的等级有: TRACE,DEBUG, INFO (默认值), WARN, NONE (没有日志).

Examples: 
--loglevel DEBUG
--loglevel DEBUG:INFO

--suitestatlevel level

设置显示在测试报告和测试日志中的test suite层数

Examples: --suitestatlevel 3

--tagstatinclude tag *

***在Statistics by Tag中只包含匹配的标签 和“测试详细信息”在日志和报告。 默认 显示全部测试用例中设置的标签。 ***

Examples: --tagstatinclude tag1

--tagstatexclude tag *

***在Statistics by Tag中不包含匹配的标签 和“测试详细信息”在日志和报告。 ***

Examples: --tagstatexclude tag1

--tagstatcombine tags:name *

组合一个标签显示,可以使用--include的操作符

Examples: 
--tagstatcombine requirement-*
--tagstatcombine tag1ANDtag2:My_name

--tagdoc pattern:doc *

给标签添加文档说明,可以用表达式匹配标签

Examples: 
--tagdoc mytag:My_documentation
--tagdoc regression:*See*_http://info.html
--tagdoc owner-*:Original_author

--tagstatlink pattern:link:title *

添加标签的状态链接和说明,例如添加bug链接

Examples: 
--tagstatlink mytag:http://my.domain:Link
--tagstatlink bug-*:http://tracker/id=%1:Bug_Tracker

--removekeywords all|passed|for|wuks|name:<pattern>|tag:<pattern> *

在测试日志中移除关键字

all: 删除所有关键字

passed:删除所有passed的测试用例的关键字

for: 删除for循环中的关键字

wuks:(保留原文,没研究出怎么生效)remove all but the last failing keyword inside BuiltIn.Wait Until Keyword Succeeds

name:<pattern>:移除表达式匹配出的关键字

Examples: 
--removekeywords name:Lib.HugeKw
--removekeywords name:myresource.*

tag:<pattern>:删除指定测试用例中匹配出的关键字

Examples: 
--removekeywords foo
--removekeywords fooANDbar*

--flattenkeywords for|foritem|name:<pattern>|tag:<pattern> *

展开关键字

for: 完全展开for循环关键字

foritem: 单独展开for循环的元素

name:<pattern>:展开匹配出的关键字

Examples:
`--removekeywords name:<pattern>`

tag:<pattern>:展开指定测试用例中匹配出的关键字

Examples:
`--removekeywords tag:<pattern>`

--listener class *

监听器

Examples: 
--listener MyListenerClass
--listener path/to/Listener.py:arg1:arg2

--warnonskippedfiles

配置这个参数后会在控制台和测试日志中显示warning信息,默认值显示info信息

--nostatusrc

测试状态码设置为0,报错的代码会正弦显示

--runemptysuite

及时测试用例集为空也执行测试,不会报没有测试用例的错误

--dryrun

验证测试用例的语法,不会真正执行测试用例

-X --exitonfailure

有任何重要的测试用例Fail的时候,结束测试执行

--exitonerror

有任何语法错误或者引用错误时直接结束测试

--skipteardownonexit

结束测试的时候跳过teardown设置

--randomize all|suites|tests|none

随机执行测试

all:随机全部的 suites 和 tests

suites: 随机 suites

tests:随机 tests

none: 没有随机 (默认)

用语法 VALUE:SEED 可以设置默认的随机种子 SEED必须是整数

Examples: 
--randomize all
--randomize tests:1234

--prerunmodifier class *

开始执行测试之前,先用程序编辑一下测试套件结构

--prerebotmodifier class *

在成成测试报告和日志之前,先用程序编辑一下测试结果的模型

--console type

设置控制台输出的方式

verbose:report every suite and test (default)

dotted: pass显示".",重要的fail显示“F”,普通fail显示”f“

quiet:除了errer和warning之外,没有输出

none: 不输出任何信息

-. --dotted

等效于--console dotted

--quiet

等效于--console quiet

-W --consolewidth chars

设置控制台信息的输出宽度,默认值”78“

-C --consolecolors auto|on|ansi|off

设置控制台输出的颜色

auto: 输出不重定向是使用颜色 (默认值)

on: 一直使用颜色

ansi: 适用于Windows

off:关闭颜色显示

注意颜色设置在 Windows 的 Jython中不是生效

-K --consolemarkers auto|on|off

显示顶层关键字标记

-P --pythonpath path *

引用库的路径

Examples: 
--pythonpath libs/
--pythonpath /opt/testlibs:mylibs.zip:yourlibs
-E star:STAR -P lib/STAR.jar -P mylib.jar

-E --escape what:with *

转义 可用的转义符: amp (&), apos ('), at (@), bslash (), colon (:), comma (,), curly1 ({), curly2 (}), dollar ($), exclam (!), gt (>), hash (#), lt (<), paren1 ((), paren2 ()), percent (%), pipe (|), quest (?), quot ("), semic (;), slash (/), space ( ), square1 ([), square2 (]), star (*)

Examples:
--escape space:_ --metadata X:Value_with_spaces
-E space:SP -E quot:Q -v var:QhelloSPworldQ

-A --argumentfile path *

参数文件

Example file:
|  --include regression
|  --name Regression Tests
|  # This is a comment line
|  my_tests.robot
|  path/to/test/directory/
Examples: 
--argumentfile argfile.txt --argumentfile STDIN

-h -? --help

帮助文档

--version

查看当前版本

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部