RobotFramework测试框架（9）--标准库常用关键字

测试-东方不败之鸭梨

已于 2024-04-06 21:25:15 修改

阅读量1.2k

点赞数 28

分类专栏： # RobotFramework 文章标签： robotframework

于 2024-04-05 23:09:58 首次发布

本文链接：https://blog.csdn.net/seanyang_/article/details/137402995

版权

RobotFramework 专栏收录该内容

17 篇文章 3 订阅

订阅专栏

标准库

RF标准库是Robot Framework（RF）在安装完成后自带的库。这些库无需额外安装，可以直接在RF中使用。其中，Builtin库是一个常用关键字库，它包含经常需要使用的关键字，无需导入即可直接使用。除Builtin库外，其他标准库如Dialogs、Collections、OperatingSystem、Remote、Screenshot和Process等，都需要通过import导入才能使用。这些库提供了丰富的功能，例如暂停测试执行和从用户获取输入、处理Python列表和字典、执行各种操作系统相关的任务、远程库接口的支持、捕获和存储桌面截图以及管理系统中运行的过程等。
https://docs.robotframework.org/docs/different_libraries/standard

Robot Framework标准库无须下载，直接导入即可使用，包括：
Builtin:包含经常需要的关键字，如Evaluate、Log关键字，该类库中的关键字自动导
入，使用前无须导入。
Dialogs:提供了暂停测试执行和从用户输入的方式，使用前需导入。
Collections:
提供一组关键词处理Python列表和字典，使用前需导入
OperatingSystem:允许执行各种操作系统相关的任务，使用前需导入。
Remote:远程库接口的一部分，没有自己的任何关键字，作为Robot Framework和测试
库之间的代理的特殊库。实际测试库可以在不同的机器上运行，可以使用任何综程语言
支持XML-RPC协议的实现，使用前需导入
Screenshot:提供关键字来捕获和存储桌面的截图，使用前需导入a
Stg:用于处理字符串并验证它们的内容，如生成、修改和验证字符串，使用前需导入。
Telnet:支持连接到Telnet服务器上，使用前需导入。
XML:用于生成、修改和验证XML文件的库，使用前需导入。
Process:系统中运行过程的库，使用前需导入.
DateTime:日期和时间转换的库，支持创建和验证日期和时间值及它们之间的计算，使
用前需导入。

Evaluate 万能关键字

在Robot Framework（RF）中，Evaluate关键字是一个非常有用的工具，它允许你直接执行Python代码，并将结果赋值给RF变量。这使得RF在需要执行复杂逻辑或调用Python库时具有更大的灵活性。

Evaluate关键字的基本语法如下：

${variable}=    Evaluate    expression    modules=None

expression：这是要执行的Python表达式或代码。
modules：可选参数，用于指定在执行表达式时需要导入的Python模块。默认为None，表示不导入任何模块。

Evaluate关键字将执行指定的Python表达式，并将结果赋值给RF变量。这样，你就可以在RF测试用例中直接使用Python的强大功能。

以下是一些使用Evaluate关键字的示例：

示例1：基本数学运算

*** Test Cases ***
Math Operations
    ${result}=    Evaluate    10 + 20
    Log    The result is: ${result}

在这个例子中，Evaluate执行了简单的加法运算，并将结果30赋值给变量${result}。
在这里插入图片描述

示例2：使用Python内置函数

*** Test Cases ***
Built-in Functions
    ${length}=    Evaluate    len("hello")
    Log    The length of "hello" is: ${length}

这里，Evaluate调用了Python的内置函数len()来获取字符串"hello"的长度，并将结果5赋值给变量${length}。
在这里插入图片描述

示例3：调用外部库

假设你有一个名为my_module的Python模块，其中有一个函数calculate_sum，你可以这样使用Evaluate来调用它：

*** Settings ***
Library    my_module.py

*** Test Cases ***
Call External Library Function
    ${sum_result}=    Evaluate    calculate_sum(10, 20)
    Log    The sum is: ${sum_result}

在这个例子中，你需要先在Settings部分导入你的Python模块。然后，在测试用例中，Evaluate调用了my_module中的calculate_sum函数，并将结果赋值给变量${sum_result}。

示例4：处理复杂逻辑

Evaluate关键字也可以处理更复杂的Python代码，只要它们能在单行中表达清楚。但请注意，对于非常复杂的逻辑或代码块，建议将其放在自定义关键字或Python测试库中，以保持测试用例的清晰和简洁。

注意事项

Evaluate关键字只能处理单行Python代码。如果你需要执行多行代码，应该考虑使用自定义关键字或Python测试库。
在使用Evaluate时，请确保你理解Python代码的含义和潜在风险，以避免引入错误或不可预测的行为。

总之，Evaluate关键字为Robot Framework提供了强大的扩展能力，使得RF能够处理更复杂的测试场景和逻辑。通过合理使用Evaluate，你可以将Python的强大功能与RF的简洁语法相结合，构建出高效、灵活的自动化测试脚本。

变量操作

打印变量 Log Variables

导入变量 import Variables

新建一个文件存放测试数据，使用Import Variables导入测试数据文件。
在这里插入图片描述

*** Variables ***
*** Test Cases ***
测试用例
        Import Variables    ${CURDIR}/variables.py
        Log     ${url}
        Log Many    @{str_list}

Set Variable 设置变量

在Robot Framework中，Set Variable 是一种用于设置标量变量的关键字。标量变量是单个值的变量，如数字、字符串等。Set Variable 关键字不仅用于设置变量的值，还可以用于将包含列表的标量变量转换为列表变量或多个标量变量。

例如，你可以使用 Set Variable 来创建一个新的变量，并在后续的测试用例或关键字中使用它。以下是一个简单的示例：

*** Test Cases ***
Example Test Case
    ${my_variable}  Set Variable       Hello, Robot Framework!
    Log    The value of my_variable is: ${my_variable}

在这个例子中，Set Variable 关键字创建了一个名为 my_variable 的变量，并赋值为 Hello, Robot Framework!。然后，Log 关键字用于打印这个变量的值。

使用这些关键字时，请确保你了解它们的作用域，以便在正确的地方设置和使用变量。同时，为了维护代码的清晰性和可维护性，建议避免在测试用例中设置全局变量，而是在适当的地方（如测试套件或项目级别）声明和设置它们。

Set Global Variable:设置全局变量

在 Robot Framework 中，Set Global Variable 关键字用于设置全局变量。全局变量是在整个测试执行期间都有效的变量，它们可以在多个测试套件、测试用例和关键字中共享和访问。

要使用 Set Global Variable 关键字，你需要确保你已经导入了 BuiltIn 库，因为这个关键字是该库的一部分。通常，BuiltIn 库是默认导入的，因此你无需显式导入它。

下面是一个示例，展示了如何使用 Set Global Variable 关键字来设置一个全局变量，并在后续的测试用例中访问它：

*** Settings ***
Library           BuiltIn

*** Variables ***
# 这里可以定义一些普通的标量变量，但它们不是全局的
${local_variable}  Local Value

*** Test Cases ***
Set Global Variable Example
    # 设置一个全局变量
    Set Global Variable    ${GLOBAL_VARIABLE}    This is a global variable

    # 在同一个测试用例中使用全局变量
    Log    The global variable is: ${GLOBAL_VARIABLE}

Another Test Case
    # 在另一个测试用例中使用全局变量
    Log    The global variable is still: ${GLOBAL_VARIABLE}

在这里插入图片描述

在这个例子中，Set Global Variable 关键字设置了一个名为 GLOBAL_VARIABLE 的全局变量，并给它赋了一个值 This is a global variable。然后，在同一个测试用例 Set Global Variable Example 和另一个测试用例 Another Test Case 中，我们都可以通过 ${GLOBAL_VARIABLE} 来访问这个全局变量的值。

请注意，全局变量通常应该谨慎使用，因为它们可以在整个测试执行期间改变，这可能会导致不可预测的行为和难以调试的问题。在可能的情况下，最好使用局部变量或测试套件变量，这样变量的作用域会更加明确和可控。

如果你需要在多个测试套件之间共享变量，你可能需要考虑使用外部文件（如 YAML、JSON 或 Python 模块）来存储这些变量，并在每个测试套件开始时导入它们。这样可以避免使用全局变量，并使变量的管理更加清晰和可维护。

Set Suite Variable：设置测试套件变量

在Robot Framework中，Set Suite Variable 关键字用于设置测试套件级别的变量。这意味着这些变量在当前执行的测试套件范围内随处可用，包括该测试套件内的所有测试用例和关键字。

当你需要在一个特定的测试套件中共享变量，而不是在整个测试项目中共享时，Set Suite Variable 是一个非常有用的工具。使用此关键字，你可以轻松地在测试套件的不同部分之间传递数据或配置信息。

以下是如何使用 Set Suite Variable 的一个简单示例：

*** Settings ***
*** Test Cases ***
Set Suite Variable Example
    # 设置一个测试套件级别的变量
    Set Suite Variable    ${SUITE_VARIABLE}    This is a suite level variable
    Log    Suite variable set to: ${SUITE_VARIABLE}

Another Test Case In Same Suite
    # 在同一个测试套件中的另一个测试用例中使用该变量
    Log    The suite variable is: ${SUITE_VARIABLE}

*** Keywords ***
Keyword In Same Suite
    [Arguments]    ${arg}
    Log    The suite variable in a keyword is: ${SUITE_VARIABLE}
    # ... 其他关键字逻辑 ...

在这个例子中，Set Suite Variable 在第一个测试用例 Set Suite Variable Example 中设置了一个名为 SUITE_VARIABLE 的测试套件变量。然后，在同一个测试套件中的另一个测试用例 Another Test Case In Same Suite 和一个关键字 Keyword In Same Suite 中，都可以访问和使用这个变量。

请注意，如果你尝试在一个不同的测试套件中访问这个变量，它将不可用，因为 SUITE_VARIABLE 的作用域仅限于设置它的那个测试套件。

使用测试套件变量是一种在测试套件内部组织和共享数据的好方法，但你需要确保不要过度依赖它们，以免降低测试的可读性和可维护性。在可能的情况下，尽量使用局部变量或参数传递来限制变量的作用
域。

Set Test Variable:设置测试用例变量

在Robot Framework中，Set Test Variable关键字用于设置当前测试用例级别的变量。这意味着这些变量仅在设置它们的特定测试用例中可用，不会影响到其他测试用例或测试套件。

当你需要在单个测试用例中存储和访问数据时，Set Test Variable是一个非常有用的工具。它允许你在测试用例内部创建和管理局部变量，以支持特定的测试逻辑或状态。

下面是一个使用Set Test Variable的简单示例：

*** Test Cases ***
Set Test Variable Example
    # 设置一个测试用例级别的变量
    Set Test Variable    ${TEST_VARIABLE}    This is a test level variable
    Log    Test variable set to: ${TEST_VARIABLE}

    # 在同一个测试用例中继续使用这个变量
    ${result}    Set Variable    ${TEST_VARIABLE} uppercased
    Log    Result: ${result}

Another Test Case
    # 在另一个测试用例中尝试访问同一个变量将会失败，因为该变量只在前一个测试用例中有效
    # 这将导致一个错误，因为${TEST_VARIABLE}在这个测试用例中未定义
     Log    This will fail: ${TEST_VARIABLE}

在这个例子中，Set Test Variable在Set Test Variable Example测试用例中设置了一个名为TEST_VARIABLE的测试用例变量。然后，在同一个测试用例中，你可以通过${TEST_VARIABLE}来访问和使用这个变量。然而，如果你尝试在另一个测试用例（如Another Test Case）中访问TEST_VARIABLE，Robot Framework会报告一个错误，因为该变量仅在前一个测试用例中定义和可用。

使用测试用例变量是组织和管理测试数据的一种好方法，特别是当数据只在单个测试用例中需要时。它有助于保持测试的独立性和清晰性，并防止不同测试用例之间的意外数据交互。然而，需要注意的是，过度使用或滥用测试用例变量可能会导致测试逻辑变得复杂和难以维护。因此，在可能的情况下，最好使用局部变量或参数传递来限制变量的作用域。

Get Variables 获取所有变量

*** Test Cases ***
Get Variables
        ${vars}     Get Variables
        Log    ${vars}

在这里插入图片描述

Get Variable Value 获取变量值

Get Environment Variables 获取所有环境变量

Get Environment Variable 获取环境变量值

Set Environment Variable 设置环境变量

关键字操作

Run Keyword ：运行关键字

所属库：BuiltIn
在Robot Framework中，Run Keyword是一个非常重要的关键字，它允许你运行（执行）一个或多个关键字。这个关键字提供了在测试执行过程中动态调用其他关键字的能力，从而增加了测试的灵活性和可重用性。

Run Keyword有几种不同的形式和用法，以下是一些常见的例子：

Run Keyword: 直接运行一个关键字。

Run Keyword    SomeKeyword    arg1    arg2

*** Settings ***
*** Test Cases ***
Run Keyword Example
        ${time}     Run Keyword    Get Time
        Log    ${time}

在这个例子中，SomeKeyword 是要运行的关键字，arg1 和 arg2 是传递给这个关键字的参数。

Run Keyword If: 当满足某个条件时运行一个关键字。
```
Run Keyword If    '${condition}' == 'True'    SomeKeyword    arg1    arg2
```
在这个例子中，如果变量 ${condition} 的值为 'True'，则执行 SomeKeyword 关键字。

你还可以使用 ELSE 和 ELSE IF 来提供分支逻辑：
```
Run Keyword If    '${condition1}' == 'True'    Keyword1
...    ELSE IF    '${condition2}' == 'True'    Keyword2
...    ELSE    Keyword3
```
Run Keyword Unless: 当条件不满足时运行一个关键字。
```
Run Keyword Unless    '${condition}' == 'False'    SomeKeyword
```
在这个例子中，如果 ${condition} 的值不为 'False'，则执行 SomeKeyword 关键字。
Run Keywords: 运行多个关键字。
```
Run Keywords    Keyword1    AND    Keyword2    AND    Keyword3
```
这个例子将依次执行 Keyword1、Keyword2 和 Keyword3。
Repeat Keyword: 重复运行某个关键字指定的次数。
```
Repeat Keyword    5 times    SomeKeyword    arg
```
这个例子将执行 SomeKeyword 关键字 5 次，每次都使用 arg 作为参数。
Run Keyword And Return: 运行关键字并返回其结果。
```
${result}=    Run Keyword And Return    SomeKeyword    arg
```
在这个例子中，SomeKeyword 的执行结果将被赋值给变量 ${result}。

请注意，Run Keyword 及其相关关键字只是 Robot Framework 中可用的众多关键字之一。为了充分利用这些功能，你需要熟悉 Robot Framework 的语法和用法，并根据你的测试需求来编写和组织你的关键字和测试用例。

条件循环

Continue For Loop:直接继续下一次循环

Continue For Loop If

Exit For Loop

Exit For Loop If

断言操作

Should (Not) Be Empty 断言是否为空

断言给定的元素是否为空

*** Settings ***
*** Test Cases ***
Run Keyword Example
        ${time}     Run Keyword    Get Time
        Should Not Be Empty    ${time}

*** Settings ***
*** Test Cases ***
Run Keyword Example
        ${time}     Run Keyword    Get Time
        Should Be Empty    ${time}

Should Be Equal 断言是否相等

Should Be Equal    first    second
Should Not Be Equal    first    second

Should Be Equal As Strings

Should Be True 断言是否为真

Should Contain 断言是否包含某元素

Should Match Regexp 断言是否匹配正则

Should Match Regexp    string    pattern

Length Should Be 断言长度是否相等

Length Should Be    item    length

Keyword Should Exist 断言关键字是否存在

Keyword Should Exist    name

List Should Contain Value 断言列表是否包含某值

所属库：Collections

Lists Should Be Equal 断言两个列表是否相等

集合操作

Create List 创建列表

Log List 打印输出列表中的值

Append To List 添加元素到列表

Insert Into List 插入元素到列表

Copy List 复制列表

Get From List 从列表中取值

常用关键字

Log 打印输出

Log Many 打印各元素值

Log To Console 打印到控制台

Sleep 延迟等待

Comment 添加注释

Call Method 调用方法

Get count 获取数量

Get Length 获取长度

Get time 获取时间

Pass Execution 标记测试用例执行成功

Fail 标记当前测试用例失败

Import Library 导入测试库

测试-东方不败之鸭梨

关注

28
点赞
踩
20

收藏

觉得还不错? 一键收藏
0
评论
RobotFramework测试框架（9）--标准库常用关键字

Robot Framework标准库无须下载，直接导入即可使用，包括：Builtin:包含经常需要的关键字，如Evaluate、Log关键字，该类库中的关键字自动导入，使用前无须导入。Dialogs:提供了暂停测试执行和从用户输入的方式，使用前需导入。提供一组关键词处理Python列表和字典，使用前需导入OperatingSystem:允许执行各种操作系统相关的任务，使用前需导入。Remote:远程库接口的一部分，没有自己的任何关键字，作为Robot Framework和测试。
复制链接

扫一扫