Robot Framework（八） 资源和变量文件

设置表

所有测试数据文件都可以使用“ 设置”表中的“ 变量”设置导入变量 ，方法与使用“ 资源” 设置导入资源文件的方式相同 。与资源文件类似，导入变量文件的路径被认为是相对于导入文件所在的目录，如果没有找到，则从PYTHONPATH中的目录中搜索。路径也可以包含变量，斜杠在Windows上转换为反斜杠。如果参数文件接受参数，则它们在路径之后的单元格中指定，并且它们也可以包含变量。

变量文件中的所有变量都可以在导入它的测试数据文件中找到。如果导入了多个变量文件并且它们包含具有相同名称的变量，则最早导入的文件中的变量文件将被使用。此外，在变量表中创建并从命令行设置的变量会覆盖变量文件中的变量。

命令行

使用变量文件的另一种方法是使用命令行选项 --variablefile。可变文件是使用将它们的路径引用的，以及可能的参数被连接到路径用冒号（：）：

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

这些文件中的变量在所有测试数据文件中全局可用，类似于使用--variable选项设置的 单个变量。如果同时使用了--variablefile和 --variable选项，并且存在具有相同名称的变量，那么使用--variable选项单独设置的变量 优先。

基本语法

当使用变量文件时，它们将作为Python模块导入，并且所有不以下划线（_）开头的全局属性都被视为变量。由于变量名称不区分大小写，因此可以使用小写和大写名称，但通常，建议使用大写字母表示全局变量和属性。

VARIABLE = "An example string"
ANOTHER_VARIABLE = "This is pretty easy!"
INTEGER = 42
STRINGS = ["one", "two", "kolme", "four"]
NUMBERS = [1, INTEGER, 3.14]

在上面的示例中，创建了变量$ {VARIABLE}， $ {ANOTHER VARIABLE}等。前两个变量是字符串，第三个是整数，后两个是列表。所有这些变量都是标量变量，甚至是包含列表作为值的变量。要创建列表变量，变量名称必须以LIST__为前缀（注意两个下划线）。

LIST__STRINGS = ["list", "of", "strings"]
LIST__MIXED = ["first value", -1.1, None, True]

上面两个示例中的变量也可以使用下面的Variable表创建。

使用对象作为值

变量文件中的变量不仅限于将字符串或其他基类型作为变量表之类的值。相反，它们的变量可以包含任何对象。在下面的示例中，变量 $ {MAPPING}包含具有两个值的Java Hashtable（此示例仅在Jython上运行测试时有效）。

from java.util import Hashtable

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

第二个示例将$ {MAPPING}创建为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)

选择要包含的变量

当Robot Framework处理变量文件时，所有不以下划线开头的属性都应该是变量。这意味着即使在变量文件中创建或从其他地方导入的函数或类也被视为变量。例如，除了$ {AREA1}和 $ {AREA2}之外，最后一个示例将包含变量$ {math} 和$ {get_area }。

通常，额外的变量不会导致问题，但是它们可能会覆盖其他一些变量并导致难以调试的错误。忽略其他属性的一种可能性是在前面添加下划线：

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)

履行

由于变量文件始终使用文件系统路径导入，因此将它们创建为类具有一些限制：

• Python类必须与它们所在的模块具有相同的名称。
• Java类必须存在于默认包中。
• Java类的路径必须以.java或.class结尾。两种情况下都必须存在类文件。

无论实现语言如何，框架都将使用无参数创建类的实例，并且将从实例获取变量。与模块类似，变量可以直接在实例中定义为属性，也可以从特殊的get_variables （或getVariables）方法获取。

当直接在实例中定义变量时，将忽略包含可调用值的所有属性，以避免从实例具有的可能方法创建变量。如果您确实需要可调用变量，则需要使用其他方法来创建变量文件。

例子

第一个示例使用Python和Java从属性创建变量。它们都从类属性创建变量$ {VARIABLE}和@ {LIST}，从实例属性创建$ {ANOTHER VARIABLE}。

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(String arg1, String arg2) {
        anotherVariable = "another value";
    }
}

第二个例子利用动态方法获取变量。它们都只创建一个变量$ {DYNAMIC VARIABLE}。

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;
    }
}