用更适合yaml的方式对requests响应进行断言

测试开发三木

于 2024-04-16 09:25:17 发布

阅读量1.1k

点赞数 6

CC 4.0 BY-SA版权

分类专栏： responses-validator 文章标签：测试工具 pytest python

本文链接：https://blog.youkuaiyun.com/python_sanmu/article/details/137809272

responses-validator 专栏收录该内容

3 篇文章

订阅专栏

概述

最近一直在捣鼓 gh action 和 k8s，学习了大量的 yaml 使用示例。

不知不觉对 yaml 有了更深的感受，于是尝试做了一个新工具，旨在用更适合 yaml 的方式对 requests 响应进行断言

理想中用于接口测试的 yaml 大概是这样子

test_name: 访问百度首页         # 用例名称steps:                   # 用例步骤   - request:             # 步骤1：发送请求      method: get              url: https://www.baidu.com     - response:           # 步骤2：断言响应      status_code: 200       text: "*baidu*"

其中：

name、steps 字段交给 pytest 处理
request 字段交给 requests 处理
response 字典交给本工具处理

简而言之，本工具实现了像 requests 那样，可以通过 yaml 来编写简单、直观的参数，

用户只需传递这些参数即完成对接口的断言，而不是编写大量的 Python 代码对参数进行判断和处理

除了 requests 外，本工具亦支持和 requests 相同接口的其他接口请求库（例如 HTTPX）

安装

本工具名为 responses-validator，暂只支持 python 3.12

安装命令如下

pip install responses-validator

为了演示本文，还需安装依赖（在实际项目，大概你已经安装过了）

pip install requests pytest-yaml-sanmu

基本用法

首先创建两个文件

第一个：配置文件 pyetst.ini

[pytest]
run_yaml_case = 1
log_file = pytest.loglog_file_level = infolog_file_format   = %(levelname)-8s %(asctime)s [%(name)s:%(lineno)s]  : %(message)slog_file_date_format  = %H:%M:%S

第二个：pytest 钩子 conftest.py

conftest 内容（双击可放大）

自此准备工作已经就绪，接下来进行接口请求和断言

断言成功的例子

创建测试用例 test_basic.yaml，内容如下

test_name: 访问百度首页         # 用例名称steps:                   # 用例步骤  - request:             # 步骤1：发送请求      method: get      url: https://www.baidu.com  - response:           # 步骤2：断言响应      status_code: 200      text: "*baidu*"

然后执行用例

pytest

执行结果和日志内容如下

pytest 执行结果（双击可放大）

日志文件内容（双击可放大）

这表示接口响应完全预期（状态码：200；响应正文：包含 "baidu"），

断言通过!

断言失败的例子

创建测试用例 test_failed.yaml，内容如下

test_name: 访问百度首页         # 用例名称steps:                   # 用例步骤  - request:             # 步骤1：发送请求      method: get      url: https://www.baidu.com  - response:           # 步骤2：断言响应      status_code: 404      text: "*sanmu*"

注意这一次，我们修改了 response 字段的内容，

即使用了新的断言条件：