参数文件


参数文件

参数文件允许将所有或某些命令行选项和参数放置到将在其中读取它们的外部文件中。这样可以避免在命令行上出现字符问题。如果需要大量选项或参数,则参数文件还可以防止命令行上使用的命令过长。

robot -L debug -t case01 -i case01 -e case02 -r my_report.html -l my_log.html suite01.robot

参数文件语法

参数文件可以包含命令行选项和测试数据的路径,每行一个选项或数据源。缩写和长选项都受支持,但建议后者,因为它们更易于理解。参数文件可以包含不转义的任何字符,但是行首和尾的空格将被忽略。此外,空行和以井号(#)开头的行将被忽略:

--doc This is an example (where "special characters" are ok!)
--metadata X:Value with spaces
--variable VAR:Hello, world!
# This is a comment
path/to/my/tests

在上面的示例中,选项及其值之间的分隔符是一个空格。可以使用等号(=)或任意数量的空格。例如,以下三行相同:

--name An Example
--name=An Example
--name       An Example

使用参数文件

参数文件可以单独使用,以便包含测试数据的所有选项和路径,也可以与其他选项和路径一起使用。当参数文件与其他参数一起使用时,其内容将放置在原始参数列表中,并位于参数文件选项所在的位置。这意味着参数文件中的选项可以覆盖它之前的选项,并且其选项可以被它后面的选项覆盖。可以多次使用--argumentfile选项,甚至可以递归使用:

robot --argumentfile all_arguments.robot
robot --name Example --argumentfile other_options_and_paths.robot
robot --argumentfile default_options.txt --name Example my_tests.robot
robot -A first.txt -A second.txt -A third.txt tests.robot