基于RobotFramework的接口自动化测试

Robot Framework

Robot Framework 是一个通用的开源自动化框架。它可以用于测试自动化和机器人过程自动化（RPA）。

Robot Framework 由 Robot Framework 框架基金会支持。许多行业领先的公司在软件开发中使用该工具。它是开放的和可扩展的，几乎可以与任何其他工具集成，以创建强大而灵活的自动化解决方案。同时它是可以免费使用，无需支付许可费用的。

Robot Framework 有一个简单的语法，利用了人类可读的关键字。它的功能可以通过使用 Python、Java 或许多其他编程语言实现的库来扩展。Robot Framework 有一个丰富的生态系统，由作为单独项目开发的库和工具组成。

基于RobotFramework的接口自动化测试 — Robot Framework

项目使用 RobotFramework 做接口自动化测试

项目的技术栈为：

Robot Framework
RequestsLibrary
HttpLibrary.HTTP

项目的基本结构图如下：

项目说明

框架使用接口分层的方式，分层规则是：接口的数据和业务分离。表现为：

项目的目录，要分层
接口的用例与数据、业务要分离
在测试用例中可以传入不定参数，同时也可以定义用例的执行顺序

目录结构说明

公共配置：主要存放一些配置文件、公用方法、公用函数
基础模块：主要存放封装的请求函数、工具函数
功能组件：主要存放一些封装好的请求组件
主干用例&项目用例：存放接口测试用例

安装 RobotFramework

首先，需要安装 RobotFramework。可以通过 pip 安装，具体命令如下：

pip install robotframework

安装相关库

接着，需要安装一些与接口自动化测试相关的库。具体命令如下：

Copy code
pip install robotframework-requests
pip install robotframework-jsonlibrary
pip install robotframework-databaselibrary

其中，robotframework-requests 用于发送 HTTP 请求，robotframework-jsonlibrary 用于处理 JSON 格式的数据，robotframework-databaselibrary 用于与数据库进行交互。

请求方法

请求方法的封装如下：

 * Settings *
Library           RequestsLibrary
Library           Collections
Library           HttpLibrary.HTTP
Resource          ../icmcenterApi/公共配置/公共配置_index.txt

* Keywords *
SendPost
    [Arguments]    ${root_url}    ${uri}    ${ParameterDict}    ${DataType}    ${header}
    [Documentation]    ${root_url}：接口的host；
    ...    ${uri}：接口uri；
    ...    ${dict}：接口传入参数，字典数据类型；
    ...    ${DataType}：传入参数类型，如data等；
    ...    ${header}：请求头，字典类型。
    ...
    ...    响应数据为json类型。
    ...
    ...    若为独立请求，可在请求结束后立即释放连接。
    ${RequestData}    Create Dictionary
    log    ${ParameterDict.keys()}
    : FOR    ${key}    IN    @{ParameterDict.keys()}
    \    set to dictionary    ${RequestData}    ${key}    ${ParameterDict['${key}']}
    log    ${RequestData}
    create session    api    ${root_url}
    ${response}    post request    api    ${uri}    ${DataType}=${RequestData}    headers=${header}    timeout=${timeout}
    #    将json的string类型的数据转成python的字典类型
    Comment    ${ResponseBody}    To Json    ${response.content}
    sleep    ${sleepTime}
    log    ${response.text}
    [Return]    ${response.text}

SendGet
    [Arguments]    ${root_url}    ${uri}    ${ParameterDict}    ${header}
    [Documentation]    响应数据为json类型
    ${RequestData}    Create Dictionary
    log    ${ParameterDict.keys()}
    : FOR    ${key}    IN    @{ParameterDict.keys()}
    \    set to dictionary    ${RequestData}    ${key}    ${ParameterDict['${key}']}
    log    ${RequestData}
    create session    api    ${root_url}
    ${response}    get request    api    ${uri}    params=${RequestData}    headers=${header}    timeout=${timeout}
    Comment    ${ResponseBody}    To Json    ${response.content}
    sleep    ${sleepTime}
    log    ${response.text}
    [Return]    ${response.text}

re_session
    [Arguments]    ${host}
    [Documentation]    创建会话
    create session    session    ${host}

re_post
    [Arguments]    ${uri}    ${ParameterDict}    ${DataType}    ${header}
    [Documentation]    不创建会话，仅发送post请求；
    ...    响应数据为json类型
    ${RequestData}    Create Dictionary
    log    ${ParameterDict.keys()}
    : FOR    ${key}    IN    @{ParameterDict.keys()}
    \    set to dictionary    ${RequestData}    ${key}    ${ParameterDict['${key}']}
    log    ${RequestData}
    ${response}    post request    session    ${uri}    ${DataType}=${RequestData}    headers=${header}    timeout=${timeout}
    Comment    ${ResponseBody}    To Json    ${response.content}
    sleep    ${sleepTime}
    log    ${response.text}
    [Return]    ${response}

re_get
    [Arguments]    ${uri}    ${ParameterDict}    ${header}
    [Documentation]    不创建会话，仅发送get请求；
    ...    响应数据为json类型
    ${RequestData}    Create Dictionary
    log    ${ParameterDict.keys()}
    : FOR    ${key}    IN    @{ParameterDict.keys()}
    \    set to dictionary    ${RequestData}    ${key}    ${ParameterDict['${key}']}
    log    ${RequestData}
    ${response}    get request    session    ${uri}    params=${RequestData}    headers=${header}    timeout=${timeout}
    Comment    ${ResponseBody}    To Json    ${response.content}
    sleep    ${sleepTime}
    log    ${response.text}
    [Return]    ${response}

新建测试用例

在测试套件上新建测试用例：

填入对应的测试用例信息：

请求

我们需要先使用 RobotFramework 创建一个 Session，这个 Session 做了这几件事：

为后面的请求提供了“容器”，之后多个请求都可以在这一个会话中发起。
保持状态，比如你创建了会话后，在会话上发起了login的接口请求并成功，后面所有在这个会话上的请求都是“已登录”状态的请求。
在会话中设置或获取的 headers 和 cookies 信息，在每次请求时都会使用，起到了“默认值”的效果。

接着到会话界面，填入基本的信息：

填写完之后，你可以直接发送请求。

也可以选择在 Session 上发送请求。

Apifox-更方便做测试

其实 RobotFramework 是属于 UI 测试工具的范畴，只能做简单的 API 测试，如果要做复杂的 API 测试，还是需要借助 Apifox 这种专业级别的 API 工具。Apifox 提供更好的可视化体验，更加方便快捷地操作，以及对于中文有要求的同学，可以选择Apifox进行测试，它提供了以下功能：