robotframework笔记13

标量变量

当使用标量变量的测试数据,它们取代了 他们被分配到的价值。 在标量变量 常用的简单字符串,您可以分配任何对象, 包括列表、。 例如,标量变量的语法 $ {名称} 大多数用户应该很熟悉,也用, 例如,在shell脚本和Perl编程语言。

下面的例子演示了使用标量变量。 假设 的变量 $ { }打招呼 和 $ {名称} 是可用的 和分配给字符串 helloworld 分别 这两个例子的测试用例是等价的。

*** Test Cases ***
Constants
    Log    Hello
    Log    Hello, world!!

Variables
    Log    ${GREET}
    Log    ${GREET}, ${NAME}!!

当一个标量变量作为唯一的价值在一个测试数据单元, 标量变量替换的值。 可能的值 任何对象。 当一个标量变量用于测试数据单元 其他(常数字符串或其他变量),它的价值是多少 首先转换为Unicode字符串,然后加任何 细胞。 转换成一个字符串的值意味着对象的 方法 __unicode__ (在Python中, __str__ 作为后备) 或 toString (在Java)。

下面的例子演示了区别 变量在一个单元中单独或与其他内容。 首先,让我们假设 我们有一个变量 $ { STR } 将一个字符串 你好, 世界! 和 $ { OBJ } 设置为以下Java的一个实例 对象:

public class MyObj {

    public String toString() {
        return "Hi, tellus!";
    }
}

与这两个变量集合,然后我们有以下测试数据:

*** Test Cases ***
Objects
    KW 1    ${STR}
    KW 2    ${OBJ}
    KW 3    I said "${STR}"
    KW 4    You said "${OBJ}"

最后,当执行这个测试数据,不同的关键字 参数说明如下:

• KW1 获得一个字符串 你好,世界!
• KW2 对象存储到变量中 $ { OBJ }
• KW3 获得一个字符串 我说:“你好,世界!”
• KW4 获得一个字符串 你说“HI TELLOUS!”

变量列表

当一个变量被用作一个标量 $ { }例子 ,它的价值 按原样使用。 如果一个变量值是一个列表或类似,这也是可能的 作为一个列表变量 @ {例子} 。 在这种情况下个人名单 项目分别作为参数传递进来。 这是最简单的解释 一个例子。 假设一个变量 @ { USER } 是有价值的 (“robot”、“秘密”) , 以下两个测试用例是等价的:

*** Test Cases ***
Constants
    Login    robot    secret

List Variable
    Login    @{USER}

机器人框架存储在一个内部存储,允许自己的变量 使用它们作为标量,列表或字典。 使用一个变量作为一个列表 需要Python列表或类似它的值对象。 机器人框架 不允许字符串用作列表,但是等iterable对象呢 元组或字典都接受。

机器人框架2.9之前,标量和列表变量是分开存储, 但它是可以使用变量作为标量和标量变量列表 列表。 这造成很多混乱时,意外是一个标量 变量和变量名称相同但不同的值列表。

*** Test Cases ***
Example
    Keyword    @{LIST}    more    args
    Keyword    ${SCALAR}    @{LIST}    constant
    Keyword    @{LIST}    @{ANOTHER}    @{ONE MORE}

*** Test Cases ***
List Variable Item
    Login    @{USER}
    Title Should Be    Welcome @{USER}[0]!

Negative Index
    Log    @{LIST}[-1]

Index As Variable
    Log    @{LIST}[${INDEX}]

*** Settings ***
Library         ExampleLibrary      @{LIB ARGS}    # This works
Library         ${LIBRARY}          @{LIB ARGS}    # This works
Library         @{NAME AND ARGS}                   # This does not work
Suite Setup     Some Keyword        @{KW ARGS}     # This works
Suite Setup     ${KEYWORD}          @{KW ARGS}     # This works
Suite Setup     @{KEYWORD}                         # This does not work
Default Tags    @{TAGS}                            # This works

字典的变量

正如上面所讨论的,一个变量包含可以用来作为一个列表 列表 变量 通过列表项关键字作为单独的参数。 同样一个变量包含Python字典或类字典 对象可以用作字典变量 & {例子} 。 在实践中 这意味着个人字典传递的物品 命名参数 关键字。 假设一个变量 & { USER } 有 价值 {“名称”:“机器人”,“密码”:“秘密”} ,以下两个测试用例 是等价的。

*** Test Cases ***
Constants
    Login    name=robot    password=secret

Dict Variable
    Login    &{USER}

字典变量新的机器人框架2.9。

*** Test Cases ***
Example
    Keyword    &{DICT}    named=arg
    Keyword    positional    @{LIST}    &{DICT}
    Keyword    &{DICT}    &{ANOTHER}    &{ONE MORE}

*** Test Cases ***
Dict Variable Item
    Login    &{USER}
    Title Should Be    Welcome &{USER}[name]!

Variable Key
    Log Many    &{DICT}[${KEY}]    &{DICT}[${42}]

*** Settings ***
Library        ExampleLibrary    &{LIB ARGS}
Suite Setup    Some Keyword      &{KW ARGS}     named=arg

环境变量

机器人框架允许使用环境变量在测试 数据使用语法 % { ENV_VAR_NAME } 。 他们是有限的字符串 值。

环境变量中设置操作系统在测试执行之前 可用时,就可以创建新的关键词 设置环境变量 或删除现有的 关键字 删除环境变量 ,两者都可用 操作 图书馆。 因为环境变量是全球性的, 环境变量中设置一个测试用例可以用于其他测试 用例执行。 然而,更改环境变量 没有有效的测试执行。

*** Test Cases ***
Env Variables
    Log    Current user: %{USER}
    Run    %{JAVA_HOME}${/}javac

Java系统属性

当与Jython运行测试时,可以访问 Java系统属性 使用相同的语法 环境变量 。 如果一个环境变量和一个 系统属性相同的名称存在,将使用环境变量。

*** Test Cases ***
System Properties
    Log    %{user.name} running tests on %{os.name}

表变量

最常见的来源表变量变量 测试用例 文件 和 资源文件 。 变量表方便,因为他们 允许创建变量在同一个地方,其余的测试 数据和所需的语法非常简单。 他们的主要缺点是 值总是字符串,他们不能被动态创建。 如果这是一个问题, 变量的文件 可以使用。

*** Variables ***
${NAME}         Robot Framework
${VERSION}      2.0
${ROBOT}        ${NAME} ${VERSION}

*** Variables ***
${NAME} =       Robot Framework
${VERSION} =    2.0

*** Variables ***
${EXAMPLE}      This value is joined    together with a space
${MULTILINE}    SEPARATOR=\n    First line
...             Second line     Third line

*** Variables ***
@{NAMES}        Matti       Teppo
@{NAMES2}       @{NAMES}    Seppo
@{NOTHING}
@{MANY}         one         two      three      four
...             five        six      seven

*** Variables ***
&{USER 1}       name=Matti    address=xxx         phone=123
&{USER 2}       name=Teppo    address=yyy         phone=456
&{MANY}         first=1       second=${2}         ${3}=third
&{EVEN MORE}    &{MANY}       first=override      empty=
...             =empty        key\=here=value

变量文件

变量创建不同的文件是最强大的机制 类型的变量。 可以将变量分配给任何对象 使用他们,他们也可以用于创建动态变量。 的 变量文件语法和考虑变量文件使用解释道 节 资源和变量文件 。

在命令行中设置变量

可以从命令行设置变量分别与 的 ——变量(- v) 选择的文件或使用一个变量 ——variablefile(- v) 选择。 从命令行设置的变量 对所有执行全局可用测试数据文件,他们也 覆盖可能的变量与变量相同的名称和表 变量在测试数据文件导入。

设置单个变量的语法 ——变量 名称:值 ,在那里 的名字 变量的名字没有 $ { } 和 价值 是它的价值。 几个变量可以 设定的多次使用这个选项。 只有标量变量 设置使用该语法,他们只能得到字符串值。 许多 特殊字符很难代表的 命令行,但是他们可以 逃了出来 与 ——逃避 选择。

--variable EXAMPLE:value
--variable HOST:localhost:7272 --variable USER:robot
--variable ESCAPED:Qquotes_and_spacesQ --escape quot:Q --escape space:_

在上面的示例中,变量设置

• $ { }例子 得到的值 价值
• $ {主机} 和 $ { USER } 得到的值 localhost:7272 和 机器人
• $ {逃脱} 得到的值 “引用和空间”

的基本语法 变量的文件 使用命令行 是 ——/ / variables.py variablefile路径 , 考虑变量文件 使用 有更多的细节部分。 变量实际上取决于创建 引用变量的变量有什么文件。

如果两个变量文件和个人变量从命令行, 后者有 更高的优先级 。

返回值的关键字

返回值的关键字也可以设置为变量。 这 即使在不同的测试允许之间的沟通不同的关键词 库。

变量组以这种方式否则类似于任何其他 变量,但它们只在可用 局部作用域 他们在哪里创建。 因此它是不可能的,例如,设置 这样的一个变量在另一个测试用例,并使用它。 这是 因为,一般来说,不应该依赖于每一个自动化测试用例 ,不小心设置一个变量,用于其他地方 可能导致难以调试的错误。 如果有一个真正的需要 设置一个变量在一个测试用例,使用它在另一个 可以使用 内装式 关键字,在下一节中解释。

*** Test Cases ***
Returning
    ${x} =    Get X    an argument
    Log    We got ${x}!

*** Test Cases ***
Example
    ${list} =    Create List    first    second    third
    Length Should Be    ${list}    3
    Log Many    @{list}

*** Test Cases ***
Example
    @{list} =    Create List    first    second    third
    Length Should Be    ${list}    3
    Log Many    @{list}

*** Test Cases ***
Example
    &{dict} =    Create Dictionary    first=1    second=${2}    ${3}=third
    Length Should Be    ${dict}    3
    Do Something    &{dict}
    Log    ${dict.first}

*** Test Cases ***
Assign Multiple
    ${a}    ${b}    ${c} =    Get Three
    ${first}    @{rest} =    Get Three
    @{before}    ${last} =    Get Three
    ${begin}    @{middle}    ${end} =    Get Three

使用 设置测试套件/全局变量 关键字

的 内装式 图书馆有关键词 设置测试变量 , 设置组变量 和 设置全局变量 它可以 用于设置变量动态测试中 执行。 如果一个变量已经存在新的范围内 值将被重写,否则创建一个新变量。

变量集 设置测试变量 关键字是可用的 随处可见范围内当前执行的测试用例。 为 例子,如果你在用户关键字设置一个变量,它是可用的 测试用例级别和所有其他用户中使用的关键字 当前的测试。 其他测试用例不会看到变量设置 关键字。

变量集 设置组变量 关键字是可用的 当前执行的测试范围内 套件。 设置变量与这个关键词有同样的效果 创建它们使用 表变量 在测试数据文件或 进口的 变量的文件 。 其他的测试套件,包括 可能孩子测试套件,不会看到变量设置 关键字。

变量集 设置全局变量 关键字是全球 可用在所有测试用例和套件设置后执行 他们。 设置变量与这个关键词有同样的效果 从命令行创建 使用的选项 ——变量 或 ——variablefile 。 因为这个字可以改变变量 无处不在,应该小心使用它。

操作系统变量

内置变量与操作系统有关减轻测试数据 operating-system-agnostic。

*** Test Cases ***
Example
    Create Binary File    ${CURDIR}${/}input.data    Some text here${\n}on two lines
    Set Environment Variable    CLASSPATH    ${TEMPDIR}${:}${CURDIR}${/}foo.jar

变量的数量

变量可以用来创建整数和语法 浮点数,见下面的例子。 这是 有用的关键字时希望得到一个实际的数字,而不是一个 字符串,看起来就像一个数字,作为参数。

*** Test Cases ***
Example 1A
    Connect    example.com    80       # Connect gets two strings as arguments

Example 1B
    Connect    example.com    ${80}    # Connect gets a string and an integer

Example 2
    Do X    ${3.14}    ${-1e-4}        # Do X gets floating point numbers 3.14 and -0.0001

也可以创建整数从二进制,八进制, 十六进制值使用 0 b , 0啊 和 0 x 分别为前缀。 语法不区分大小写。

*** Test Cases ***
Example
    Should Be Equal    ${0b1011}    ${11}
    Should Be Equal    ${0o10}      ${8}
    Should Be Equal    ${0xff}      ${255}
    Should Be Equal    ${0B1010}    ${0XA}

布尔和没有/空变量

布尔值和Python 没有一个 和Java 零 可以 使用变量语法创建同样的数字。

*** Test Cases ***
Boolean
    Set Status    ${true}               # Set Status gets Boolean true as an argument
    Create Y    something   ${false}    # Create Y gets a string and Boolean false

None
    Do XYZ    ${None}                   # Do XYZ gets Python None as an argument

Null
    ${ret} =    Get Value    arg        # Checking that Get Value returns Java null
    Should Be Equal    ${ret}    ${null}

这些变量是不区分大小写的,举个例子 $ {真} 和 $ {真} 是等价的。 此外, $ {一} 和 $ {零} 是同义词,因为当在Jython运行测试吗 Jython解释器,自动转换 没有一个 和 零 必要时,正确的格式。

空间和空的变量

可以使用变量创建空间和空字符串 $ {空间} 和 $ {空} ,分别。 这些变量是 有用的,例如,否则会有需要的时候出现 逃避 空格或空的细胞 一个反斜杠。 如果一个以上的空间 需要的话,可以使用 扩展变量语法 就像 $ {空间* 5 } 。 在接下来的例子中, 应该是 平等的 但是那些使用变量是关键字得到相同的参数 更容易理解比使用反斜杠。

*** Test Cases ***
One Space
    Should Be Equal    ${SPACE}          \ \

Four Spaces
    Should Be Equal    ${SPACE * 4}      \ \ \ \ \

Ten Spaces
    Should Be Equal    ${SPACE * 10}     \ \ \ \ \ \ \ \ \ \ \

Quoted Space
    Should Be Equal    "${SPACE}"        " "

Quoted Spaces
    Should Be Equal    "${SPACE * 2}"    " \ "

Empty
    Should Be Equal    ${EMPTY}          \

还有一个空的 变量列表 @ {空} 和一个空 字典 变量 & {空} 。 因为他们没有内容,基本上 在测试数据使用时消失。 他们是有用的,例如, 与 测试模板 当 模板使用关键字 参数 或者当变量在不同覆盖列表或字典 范围。 修改的值 @ {空} 或 & {空} 是不可能的。

*** Test Cases ***
Template
    [Template]    Some keyword
    @{EMPTY}

Override
    Set Global Variable    @{LIST}    @{EMPTY}
    Set Suite Variable     &{DICT}    &{EMPTY}

自动变量

也可以使用一些自动变量的测试数据。 这些 变量可以在测试执行和一些有不同的价值观 他们甚至没有可用的。 改变的价值 这些变量并不影响原来的值,但是一些值 可以动态地改变使用关键字的 内装式 图书馆。

套件相关的变量 $ {套件来源} , $ {套件名称} , $ {套件文档} 和 & {套件元数据} 是 可用的测试库和变量文件时已经导入, 除了机器人框架2.8和2.8.1发布这个支持被打破了。 可能的变量在这些自动变量还没有解决 不过,在导入时间。

变量的优先级

变量从命令行

变量 在命令行中设置 最高优先级的 变量可以设置在实际测试执行之前就开始了。 他们 覆盖可能的变量变量表中创建测试用例 文件,以及在资源和变量文件导入 测试数据。

单独设置变量( ——变量 选项)覆盖 变量设置使用 变量的文件 ( ——variablefile 选项)。 如果您指定同一个人变量多次,指定的一个 最后将会覆盖之前的。 这允许设置的默认值 变量在一个 启动脚本 并从命令行覆盖它们。 不过,请注意,如果多个变量文件具有相同的变量, 指定的文件的第一个具有最高的优先级。

表在一个测试用例文件变量

创建的变量使用 表变量 在一个测试用例文件中 可用于该文件中的所有测试用例。 这些变量 覆盖在进口资源和具有相同名称的变量 变量的文件。

变量变量中创建表可用在所有其他表 他们在哪里创建的文件。 这意味着他们可以使用 在设置表中,例如,对于进口更多的变量 资源文件和变量。

进口资源和变量文件

变量的进口 资源和变量文件 有 最低优先级的所有变量创建测试数据。 从资源文件中变量和变量有相同的文件 优先级。 如果一些资源和/或变量具有相同的文件 变量的文件中第一次被导入到使用。

如果一个资源文件导入资源文件或变量文件, 表变量的变量有一个更高的优先级 变量进口。 所有这些变量对文件可用 导入该资源文件。

注意,从资源和进口变量变量文件 可用的变量进口表的文件。 这 是由于变量表前处理设置表吗 资源文件和变量文件都是进口的。

在测试执行期间设置的变量

在测试执行使用变量设置 返回值 从关键字 或 使用关键字设置测试/套件/全局变量 总是覆盖可能的现有 变量的范围设置。在某种意义上,他们如此 最高优先级,但另一方面他们不影响吗 变量超出了定义范围。

内置的变量

内置的变量 就像 $ { TEMPDIR } 和 $ { TEST_NAME } 所有变量的优先级最高。 他们不能被覆盖 使用变量表或从命令行,但即使他们可以重置期间 测试执行。 这个规则的例外 变量的数量 ,这 如果没有发现其他变量动态解析。 因此可以 覆盖,但通常是一个坏主意。 另外 $ { CURDIR } 是特殊的,因为它已经取代了在测试数据处理时间。

变量作用域

取决于他们在哪里以及如何创建,可以有一个变量 全球测试套件、测试用例或局部作用域。

扩展变量语法

扩展变量语法允许访问一个对象的属性 给一个变量(例如, $ { object.attribute } ),甚至打电话 它的方法(例如, $ { obj.getName()} )。 它的工作原理与 标量变量列表,但前者主要是有用的

扩展变量语法是一种强大的功能,但它应该 小心使用。 访问属性通常不是一个问题 相反,因为一个包含对象和几个变量 属性通常是比有几个变量。 在 另一方面,调用方法,尤其是当他们使用 参数,可以使测试数据很复杂的理解。 如果出现这种情况,建议移动到一个测试库的代码。

最常见的用法扩展变量的语法 在下面的例子中。 首先假设我们有以下 变量文件 和测试用例:

class MyObject:

    def __init__(self, name):
        self.name = name

    def eat(self, what):
        return ‘%s eats %s‘ % (self.name, what)

    def __str__(self):
        return self.name

OBJECT = MyObject(‘Robot‘)
DICTIONARY = {1: ‘one‘, 2: ‘two‘, 3: ‘three‘}

*** Test Cases ***
Example
    KW 1    ${OBJECT.name}
    KW 2    ${OBJECT.eat(‘Cucumber‘)}
    KW 3    ${DICTIONARY[2]}

当执行这个测试数据,关键字参数作为 解释如下:

• KW1 得到字符串 Robot

• KW2 得到字符串 robo teats Cucumber
• KW3 得到字符串 two


按照以下顺序扩展变量语法评估:

1. 变量是使用完整的变量名称搜索。 扩展的 评估变量的语法只有在没有匹配的变量 是发现。
2. 创建基本变量的名称。 身体的名字 包括开始后所有的人物 { 直到 第一次出现的角色不是一个字母数字字符 或空间。 例如,基础的变量 $ { OBJECT.name } 和 $ {词典[2]} ) 对象和 字典 , 分别。
3. 一个变量匹配搜索。 如果没有匹配,一个 异常,测试用例失败。
4. 花括号内的表达式求值作为一个Python 表达,所以基本变量名替换它 价值。 如果评估失败,因为一个无效的语法 查询属性不存在,会抛出一个异常并 测试失败。
5. 整个扩展变量替换为返回的值 从评估。

如果使用的对象是使用Java实现,扩展 变量的语法允许您使用所谓的bean访问属性 属性。 从本质上讲,这意味着如果你有对象了 getName 方法设置成一个变量 $ { OBJ } ,那么 语法 $ { OBJ.name } 相当于但清晰吗 $ { OBJ.getName()} 。 在上一个示例中使用的Python对象 因此可以替换为以下Java实现:

public class MyObject:

    private String name;

    public MyObject(String name) {
        name = name;
    }

    public String getName() {
        return name;
    }

    public String eat(String what) {
        return name + " eats " + what;
    }

    public String toString() {
        return name;
    }
}

许多标准的Python对象,包括字符串和数字 方法可以用于扩展变量语法 显式或隐式。 有时这可以真正有用的和 减少需要设置临时变量,但也容易 过度使用它并创建真正的测试数据。 下面的例子 显示一些不错的用法。

*** Test Cases ***
String
    ${string} =    Set Variable    abc
    Log    ${string.upper()}      # Logs ‘ABC‘
    Log    ${string * 2}          # Logs ‘abcabc‘

Number
    ${number} =    Set Variable    ${-2}
    Log    ${number * 10}         # Logs -20
    Log    ${number.__abs__()}    # Logs 2

注意,即使 abs(数量) 建议在 number.__abs__() 在正常的Python代码,使用 $ { abs(数量)} 不工作。 这是因为变量名 必须在扩展语法的开始。 使用 __xxx__ 这样的方法在测试数据已经有点可疑,和 最好通常是这种逻辑转移到测试库中。

扩展变量语法也在工作 变量列表 上下文。 例如,如果一个对象分配给一个变量 $ {扩展} 有 一个属性 属性 包含一个列表作为一个值,它可以 用作变量列表 @ { EXTENDED.attribute }。

扩展变量赋值

从机器人Framework 2.7开始,可以设置的属性 对象存储使用标量变量 关键字返回值 和 的一个变种 扩展变量语法 。 假设我们有 变量 $ {对象} 从前面的示例中,属性 被设置为像下面例子所示的那样。

*** Test Cases ***
Example
    ${OBJECT.name} =    Set Variable    New name
    ${OBJECT.new_attr} =    Set Variable    New attribute

评估使用的扩展变量赋值语法 以下规则:

1. 分配的变量必须是一个标量变量,至少有 一个点。 否则,赋值语法不使用和扩展 正常的变量被分配。
2. 如果存在一个变量的全名 (如。 $ { OBJECT.name } 在上面的示例中,变量 将指定一个新值,不使用扩展语法。
3. 创建基本变量的名称。 身体的名字 包括所有的人物之间的开放 $ { 和 最后一个点,例如, 对象 在 $ { OBJECT.name } 和 foo.bar 在 $ { foo.bar.zap } 。 在第二个例子 所示,基本名称可能包含正常扩展变量 语法。
4. 属性的名称设置所有制造而成 字符之间的最后一个点和结束 } ,因为 的例子, 的名字 在 $ { OBJECT.name } 。 如果名字不 以字母或下划线开始和只包含这些字符 和数字,属性被认为是无效的和扩展的 不使用语法。 创建一个新变量的全名 代替。
5. 一个变量匹配基本名称搜索。 如果没有变量 发现,不使用扩展语法,相反,一个新的变量 创建使用完整的变量名。
6. 如果发现变量是一个字符串或一个数字,扩展语法 被忽略和创建一个新变量使用全名。 这是 因为你不能到Python字符串或添加新属性 数字,这样新语法也更少 向后不兼容的。
7. 如果所有前面的规则匹配,该属性被设置为基础 变量。 如果设置由于某种原因失败,会抛出一个异常 和测试失败。

变量内部变量

变量也允许在变量,当这个语法 使用变量从内而外的解决。 例如,如果你 有一个变量 $ { var $ { x } } ,然后 $ { x } 解决 第一。 如果它有价值 的名字 然后,最后一个值 值的变量$ { varname } 。 可以有多个嵌套 变量,但解决最外层的失败,如果他们不 存在。

在下面的示例中, 做X 得到的值 $ {约翰回家} 或 $ {简家} ,这取决于如果 得到的名字 返回 约翰 或 简 。 如果它返回别的东西,解决 $ { $ {名称}回家} 失败。

*** Variables ***
${JOHN HOME}    /home/john
${JANE HOME}    /home/jane

*** Test Cases ***
Example
    ${name} =    Get Name
    Do X    ${${name} HOME}