HttpRunner 接口测试框架

最新推荐文章于 2025-02-09 10:53:35 发布

原创最新推荐文章于 2025-02-09 10:53:35 发布 · 1.1k 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#软件测试 #测试开发

什么是 HttpRunner？

HttpRunner 是一个通过命令行和 YAML 文件进行接口测试的开源框架，旨在为我们提供一种简洁、灵活的方式来进行自动化测试。该框架支持 HTTP/HTTPS 请求，能够有效处理接口的不同状态，生成测试报告，并且通过与多种测试框架（如 unittests、pytest）结合，增强其可扩展性。

HttpRunner 的功能

易于上手：拥有清晰的文档，帮助新手快速入门。
灵活性：支持多种请求类型，包括 GET、POST、PUT、DELETE 等。
集成功能：能够与 CI/CD 工具（如 Jenkins）结合，提高自动化测试效率。
强大的数据驱动支持：支持从 CSV、JSON 等多种格式读取测试数据。
可读性高的测试用例：采用 YAML 格式，使得测试用例更友好且易于维护。

如何使用 HttpRunner？

在我们动手实践之前，让我们先了解 HttpRunner 如何解决接口测试中的一些常见问题。它的主要目标是让我们在进行接口测试时，更容易发现和修复问题，而不被繁琐的步骤所困扰。

使用方法概述

安装 HttpRunner

确保已安装 Python。可以通过命令 python --version 验证该信息。
然后，通过 pip 安装 HttpRunner：

pip install HttpRunner

创建测试用例

创建一个 YAML 文件来定义测试用例，下面是一个基本的示例：Yaml

config:
  name: example_test
  api_version: v1
test:
  - name: test_get_request
    request:
      url: http://ceshiren.com/api/example
      method: GET
    validate:
      - eq: [status_code, 200]

在这里，我们定义了一个简单的 GET 请求测试。

执行测试用例

使用以下命令行执行我们的测试用例：

hrunner run example_test.yml

生成测试报告

HttpRunner 自动生成 HTML 格式的测试报告，便于审核与分析。

集成 CI/CD 流程

将 HttpRunner 与 Jenkins 等工具集成，可以在代码每次提交时自动运行测试，提高测试的覆盖率和效率。

具体示例

示例 1：测试 GET 请求

config:
  name: get_example
  api_version: v1
test:
  - name: test_get_request
    request:
      url: http://ceshiren.com/api/get_example
      method: GET
    validate:
      - eq: [status_code, 200]
      - eq: [response.body.id, 1]

步骤：

创建 get_example.yml 文件。
添加上面代码。
使用命令 hrunner run get_example.yml 执行测试。
查看生成的报告。

示例 2：测试 POST 请求

config:
  name: post_example
  api_version: v1
test:
  - name: test_post_request
    request:
      url: http://ceshiren.com/api/post_example
      method: POST
      json:
        name: "test"
        age: 25
    validate:
      - eq: [status_code, 201]
      - eq: [response.body.message, "success"]

步骤：

创建 post_example.yml 文件。
填入上面代码。
命令行执行 hrunner run post_example.yml。
审核生成的测试结果。

示例 3：数据驱动测试

config:
  name: data_driven_example
  api_version: v1
test:
  - name: test_data_driven
    request:
      url: http://ceshiren.com/api/data_driven_example
      method: POST
      json:
        name: ${name}
        age: ${age}
    validate:
      - eq: [status_code, 201]
      - eq: [response.body.message, "success"]
data:
  - name: "Alice"
    age: 30
  - name: "Bob"
    age: 22