robotframework笔记15

资源和变量文件

用户关键字和变量 测试用例文件 和 测试套件 初始化文件只能用于文件在哪里 了,但 资源文件 提供一种机制来分享它们。 自 资源文件结构非常接近测试用例文件,它是 容易创建它们。

变量的文件 提供一个强大的机制来创建和分享 变量。 例如,他们允许字符串和之外的值 启用动态创建变量。 他们的灵活性来自 他们创建使用Python代码,这也使得 他们更复杂得多表变量 。

资源文件

考虑到资源文件使用

资源文件导入使用 资源 设置在 设置表。 资源文件的路径在细胞中 设置后的名字。

如果路径中给出了一个绝对的格式,它是直接使用。 在其他 情况下,首先搜索相对资源文件的目录 导入文件的位置。 如果文件没有找到, 然后从Python的目录搜索 模块搜索路径 。 路径可以包含变量,并推荐使用他们的路径 系统(例如, $ {资源} / login_resources.html 或 $ { RESOURCE_PATH } )。 另外,斜杠( / )的路径 将自动改为反斜杠( \ 在Windows上)。

*** Settings ***
Resource    myresources.html
Resource    ../data/resources.html
Resource    ${RESOURCES}/common.tsv

用户关键字和变量定义在一个资源文件 可用的文件,资源文件 使用。 同样也在所有的关键字和变量可用 库、资源文件和变量文件导入的说 资源文件。

资源文件结构

资源文件的高级结构是一样的 当然,否则测试用例文件,但是他们不能包含测试 例表。 此外,在资源文件可以设置表 只包含进口设置( 图书馆 , 资源 , 变量 ), 文档 。 变量表和 使用关键字表完全相同的方法在测试用例文件。

如果一些资源文件用户具有相同名称的关键字,他们 必须使用的吗 关键字名称前缀与资源 文件名称 没有扩展(例如, myresources.Some 关键字 和 常见的。 一些关键字 )。 此外,如果一些资源 文件包含相同的变量,一个是第一次进口 考虑使用。

记录资源文件

关键字在一个资源文件可以创建 记录 使用 (文档) 设置。 资源文件本身 文档 设置表中同样 测试套件 。

这两个 Libdoc 和 骑 使用这些文件,他们 天生对任何人打开资源文件可用。 的 第一行的文档关键字记录当它运行时, 否则测试期间的资源文件文件将被忽略 执行。

资源文件示例

*** Settings ***
Documentation     An example resource file
Library           Selenium2Library
Resource          ${RESOURCES}/common.robot

*** Variables ***
${HOST}           localhost:7272
${LOGIN URL}      http://${HOST}/
${WELCOME URL}    http://${HOST}/welcome.html
${BROWSER}        Firefox

*** Keywords ***
Open Login Page
    [Documentation]    Opens browser to login page
    Open Browser    ${LOGIN URL}    ${BROWSER}
    Title Should Be    Login Page

Input Name
    [Arguments]    ${name}
    Input Text    username_field    ${name}

Input Password
    [Arguments]    ${password}
    Input Text    password_field    ${password}

变量文件

变量文件包含 变量 在测试中,可以使用 数据。 变量也可以使用变量创建表或设置 命令行,但变量文件允许动态地创建它们 和他们的变量可以包含任何对象。

变量文件通常作为Python模块和实现 两种不同的方法来创建变量:

创建变量直接

变量指定为模块属性。 在简单的情况下, 语法非常简单,不需要真正的编程。 例如, MY_VAR = '我的价值 创建一个变量 $ { MY_VAR } 与指定的文本值。

得到特殊函数的变量

变量可以有一个特殊的文件 get_variables (或 getVariables 作为一个映射)方法,它返回变量。 这种方法,因为方法可以把参数是非常灵活的。

或者可以实现为变量文件 Python或Java类 该框架将实例化。 在这种情况下,可以创建 变量属性或让他们从一个特殊的方法。

考虑变量文件使用

设置表

所有测试数据文件可以导入变量使用 变量 设置中设置表,以同样的方式 资源文件都是进口的 使用 资源 设置。 同样的资源文件,导入的路径 变量文件被认为是相对于的目录 导入文件,如果没有找到,它是搜索的 目录 模块搜索路径 。 也可以包含路径变量, 和斜杠转换为Windows上的反斜杠。 如果一个 参数文件需要 参数 后,它们是细胞中指定的路径和也 可以包含变量。

*** Settings ***
Variables    myvariables.py
Variables    ../data/variables.py
Variables    ${RESOURCES}/common.py
Variables    taking_arguments.py    arg1    ${ARG2}

所有变量从一个变量文件中可用的测试数据文件 进口。 如果几个变量文件进口和他们 包含一个变量具有相同名称的,最早的进口文件 考虑使用。 此外,表和变量中创建变量 从命令行设置覆盖从变量文件变量。

命令行

考虑变量文件使用的另一种方法是使用命令行选项 ——variablefile 。 变量引用文件使用的路径, 和可能的路径参数加入一个冒号( : ):

--variablefile myvariables.py
--variablefile path/variables.py
--variablefile /absolute/path/common.py
--variablefile taking_arguments.py:arg1:arg2

从机器人框架2.8.2,变量的文件中使用 命令行也的搜索 模块搜索路径 同样作为 变量设置表中导入的文件。

如果一个变量文件作为一个绝对Windows路径,冒号后 驱动器并不认为是一个分隔符:

--variablefile C:\path\variables.py

从机器人框架2.8.7,也可以使用分号 ( ; )作为参数分隔符。 这是非常有用的,如果变量文件参数 包含冒号,但是需要周围的整个价值 引用在类unix操作系统:

--variablefile "myvariables.py;argument:with:colons"
--variablefile C:\path\variables.py;D:\data.xls

变量在这些变量在所有测试数据文件是全局可用 文件,同样是 单独的变量 设置的 ——变量 选择。 如果两个 ——variablefile 和 ——变量 选择和使用有变量相同 的名字,那些单独设置 ——变量 选择优先考虑。

创建变量直接

基本语法

当变量文件被使用时,他们作为Python导入 模块和全球所有属性不从一开始 下划线( _ )被认为是变量。 因为变量 名称不区分大小写,大写字母的名称 可能的,但一般来说,大写字母是全球的建议 变量和属性。

VARIABLE = "An example string"
ANOTHER_VARIABLE = "This is pretty easy!"
INTEGER = 42
STRINGS = ["one", "two", "kolme", "four"]
NUMBERS = [1, INTEGER, 3.14]
MAPPING = {"one": 1, "two": 2, "three": 3}

在上面的示例中,变量 变量$ { } , 另一个变量$ { } , 创建。 前两个变量是字符串,第三个是 一个整数,然后有两个列表,最后的值是一个字典。 所有这些变量可以用作 标量变量 、列表和 字典也 变量列表 就像 @ {字符串} (在字典的情况下 该变量只包含键),字典也 字典变量 就像 & {映射} 。

要创建一个变量或一个字典列表变量更加明确, 是可能的前缀的变量名 LIST__ 或 DICT__ , 分别为:

from collections import OrderedDict

LIST__ANIMALS = ["cat", "dog"]
DICT__FINNISH = OrderedDict([("cat", "kissa"), ("dog", "koira")])

这些前缀不会最终变量名称的一部分,但他们的事业 机器人框架来验证实际上是类似或价值 类字典。 字典存储的实际价值也转过身 当使用到一个特殊的字典 创建字典 变量 在变量表。 这些字典的值是可访问的 等属性 $ { FINNISH.cat } 。 这些字典也下令,但是 保留源订单还需要原来的字典 命令。

变量在两个上面的例子也可以创建使用 变量下表。

*** Variables ***
${VARIABLE}            An example string
${ANOTHER VARIABLE}    This is pretty easy!
${INTEGER}             ${42}
@{STRINGS}             one          two           kolme         four
@{NUMBERS}             ${1}         ${INTEGER}    ${3.14}
&{MAPPING}             one=${1}     two=${2}      three=${3}
@{ANIMALS}             cat          dog
&{FINNISH}             cat=kissa    dog=koira

请注意

变量不替换字符串从变量文件。 例如, VAR = " $ {例子}” 将创建 变量 $ { VAR } 文字字符串值 一个$ {例子} 无论将变量 $ { }例子 存在与否。

使用对象作为值

变量变量并不仅限于只有字符串或文件 其他基本类型变量等值表。 相反,他们 变量可以包含任何对象。 在下面的示例中,变量 $ {映射} 包含一个Java散列表(这两个值 在Jython例子只能当运行测试)。

from java.util import Hashtable

MAPPING = Hashtable()
MAPPING.put("one", 1)
MAPPING.put("two", 2)

第二个例子创建 $ {映射} 作为一个Python字典 还有两个变量从一个自定义创建对象中实现 相同的文件。

MAPPING = {'one': 1, 'two': 2}

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

OBJ1 = MyObject('John')
OBJ2 = MyObject('Jane')

创建变量动态

因为变量文件创建使用一个真正的编程语言, 他们可以动态设置变量的逻辑。

import os
import random
import time

USER = os.getlogin()                # current login name
RANDOM_INT = random.randint(0, 10)  # random integer in range [0,10]
CURRENT_TIME = time.asctime()       # timestamp like 'Thu Apr  6 12:45:21 2006'
if time.localtime()[3] > 12:
    AFTERNOON = True
else:
    AFTERNOON = False

上面的例子使用标准Python库设置不同 变量,但是您可以使用您自己的代码构建的价值。 的 下面的例子说明了这个概念,但同样的,你的代码 从数据库中读取数据,从一个外部文件甚至问它 用户。

import math

def get_area(diameter):
    radius = diameter / 2
    area = math.pi * radius * radius
    return area

AREA1 = get_area(1)
AREA2 = get_area(2)

选择变量包括

当机器人框架流程变量文件,所有的属性 不从下划线预计将开始 变量。 这意味着即使函数或类中创建的 变量文件或从其他地方进口的是变量。 为 最后一个例子将包含的变量 $ {数学} 和 $ { get_area } 除了 $ { AREA1 } 和 $ { AREA2 } 。

通常不会引起额外的变量问题,但他们 可以覆盖其他变量,导致难以调试的 错误。 一种可能忽略其他属性是前缀 下划线:

import math as _math

def _get_area(diameter):
    radius = diameter / 2.0
    area = _math.pi * radius * radius
    return area

AREA1 = _get_area(1)
AREA2 = _get_area(2)

如果有大量的其他属性,而不是加前缀 ,通常是更容易使用一个特殊的属性 __all__ 并赋予它处理属性名称的列表 作为变量。

import math

__all__ = ['AREA1', 'AREA2']

def get_area(diameter):
    radius = diameter / 2.0
    area = math.pi * radius * radius
    return area

AREA1 = get_area(1)
AREA2 = get_area(2)

请注意

的 __all__ 属性也和最初,使用 通过Python决定哪些属性导入 当使用语法 从modulename进口* 。

得到特殊函数的变量

另一种方法获得变量是有一个特别的 get_variables 函数(也camelCase语法 getVariables 是可能的)在一个变量文件。 如果这样的一个函数 存在,机器人框架调用它,愿接收变量 Python字典或Java 地图 变量名称作为键 和变量值的值。 创建变量可以作为标量、 列表和字典时一模一样 创建变量直接 , 它可以使用 LIST__ 和 DICT__ 前缀来创建 列表和字典更明确的变量。 下面的例子是功能 相同的第一个 创建变量直接 的例子。

def get_variables():
    variables = {"VARIABLE ": "An example string",
                 "ANOTHER VARIABLE": "This is pretty easy!",
                 "INTEGER": 42,
                 "STRINGS": ["one", "two", "kolme", "four"],
                 "NUMBERS": [1, 42, 3.14],
                 "MAPPING": {"one": 1, "two": 2, "three": 3}}
    return variables

get_variables 也可以争论,有助于改变吗 哪些变量实际上是创建。 参数设置功能 作为一个Python函数任何其他参数。 当 把变量文件 投入使用 测试数据,参数中指定的路径后细胞 变量文件,在命令行中他们是分开的 路径与冒号或分号。

下面的虚拟的例子显示了如何使用变量参数文件。 在一个 更现实的例子,论证可以通往外部文本文件 或数据库读取变量。

variables1 = {'scalar': 'Scalar variable',
              'LIST__list': ['List','variable']}
variables2 = {'scalar' : 'Some other value',
              'LIST__list': ['Some','other','value'],
              'extra': 'variables1 does not have this at all'}

def get_variables(arg):
    if arg == 'one':
        return variables1
    else:
        return variables2

实现变量文件作为Python或Java类

从机器人Framework 2.7开始,可以实现变量文件 Python和Java类。

实现

因为变量文件总是进口使用文件系统路径创造 这些类有一些限制:

• Python类必须有名称相同的模块。
• 必须住在默认包的Java类。
• Java类路径必须结束 . java 或 . class 。 类文件必须在这两种情况下存在。

不管实现语言,框架将创建一个实例 类的不使用参数和变量将得到的实例。 同样与模块,直接变量可以定义为属性 在实例或从特殊了 get_variables (或 getVariables )方法。

当变量直接定义一个实例,包含所有属性 可调用的值将被忽略,以避免创建变量从可能的方法 实例。 如果你会需要可调用的变量,你所需要的 使用其他方法来创建变量文件。

例子

第一个例子使用Python和Java创建变量的属性。 他们两人创建变量 变量$ { } 和 @ {列表} 从类 属性和 另一个变量$ { } 从一个实例属性。

class StaticPythonExample(object):
    variable = 'value'
    LIST__list = [1, 2, 3]
    _not_variable = 'starts with an underscore'

    def __init__(self):
        self.another_variable = 'another value'

public class StaticJavaExample {
    public static String variable = "value";
    public static String[] LIST__list = {1, 2, 3};
    private String notVariable = "is private";
    public String anotherVariable;

    public StaticJavaExample() {
        anotherVariable = "another value";
    }
}

第二个例子使用动态方法获取变量。 这两个 他们只创建一个变量 动态变量$ { } 。

class DynamicPythonExample(object):

    def get_variables(self, *args):
        return {'dynamic variable': ' '.join(args)}

import java.util.Map;
import java.util.HashMap;

public class DynamicJavaExample {

    public Map<String, String> getVariables(String arg1, String arg2) {
        HashMap<String, String> variables = new HashMap<String, String>();
        variables.put("dynamic variable", arg1 + " " + arg2);
        return variables;
    }
}

变量文件作为YAML

变量也可以实现为文件 YAML 文件。 YAML是一种数据序列化的语言与一个简单的和人性化的语法。 下面的示例演示了一个简单的YAML文件:

string:   Hello, world!
integer:  42
list:
  - one
  - two
dict:
  one: yksi
  two: kaksi
  with spaces: kolme

请注意

需要使用YAML文件与机器人框架 PyYAML 模块安装。 如果你有 pip安装,可以安装它只需运行 pip安装pyyaml 。

YAML支持新的机器人框架2.9。 从 2.9.2版本, 独立的JAR分布 有 PyYAML包括默认情况下。

可以使用YAML变量文件完全一样正常变量文件 从命令行中使用 ——variablefile 的选项,设置 表的使用 变量 设置,并动态地使用 导入变量 关键字。 要记住的唯一路径 YAML文件必须结束 .yaml 扩展。

如果上面的YAML文件导入,它将创建完全相同的 变量如表:以下变量

*** Variables ***
${STRING}     Hello, world!
${INTEGER}    ${42}
@{LIST}       one         two
&{DICT}       one=yksi    two=kaksi

YAML文件用作变量文件必须在顶级映射。 上面的例子表明,键和值的映射 分别的变量名和值。 变量的值可以是任何数据 YAML的语法支持的类型。 如果名称或值包含非ascii 字符,YAML文件变量必须是utf - 8编码。

映射用作值自动转换成特殊的字典 当使用 创建字典变量 在变量表。 最重要的是,这些字典都可以访问的属性值 就像 $ { DICT.one } ,假设他们的名字是有效的Python的属性名称。 如果名称包含空格或否则不是一个有效的属性名称,它是 总是可以访问字典值使用语法 & { DICT }(空间) 语法。 创建字典也下令,但是 不幸的是在YAML文件的原始顺序不保存。