1. 前言


原始测试金子塔包含 3 层,分别是:UI 自动化测试、接口服务测试、单元测试
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_HttpRunner

其中,单元测试是对软件的最小可测试单元进行检查和验证,也是产生效率最大的一项测试

接口服务测试分为模块接口测试和协议接口测试

UI 测试主要是为了取代人力操作,通过 UI 自动化去模拟操作,降低回归测试的成本

考虑到投入产出率,大部分企业都会将测试重点放在接口自动化测试这一项上

接口自动化主流方案包含:Python + Pytest/Unittest、Java + TestNG、Postman、HttpRunner、Postman、Jmeter、RobotFramework等

本篇文章将和大家一起聊聊HttpRunner做接口自动化的流程

2.介绍及安装


HttpRunner 是一款完全由 Python 语言编写的测试框架,并且简单、优雅、功能强大,同时支持 HTTP 和 HTTPS

HttpRunner 主要包含下列特征:

  • 继承 Requests 库的全部特性,轻松实现 HTTP(S) 的各种测试需求

  • 以 YAML 和 JSON 定义测试用例,通过 pytest 去运行

  • 基于 HAR 文件,实现接口的录制及用例的生成功能

  • 支持 variables、extract、validate、hook 等关键字,可以创建复杂的测试场景

  • 借助辅助插件 debugtalk.py,在测试脚本中轻松实现复杂的动态计算逻辑

  • 集成 jmespath,方便提取变量、验证 JSON 响应

  • 集成 pytest,支持大量的插件

  • 集成 allure 生成强大的测试报告

  • 集成 locust,非常方便做性能测试

  • 执行方式采用 CLI 调用形式,可以和 Jenkins 等持续集成工具完美结合

使用 pip 安装 HttpRunner 稳定版本

# 安装 HttpRunner 稳定版本pip3 install httprunner

需要指出的是,HttpRunner V3 版本对比 V2 版本进行了大量优化,特别是测试用例的表现形式,强烈建议安装 V3 版本

3.常见命令


安装完 HttpRunner 之后,就可以使用下面几个命令了

1、hrun

HttpRunner 最主要的命令,主要作用是运行 Py/YAML/JSON 格式的测试用例

2、hmake

将 YAML/JSON 格式的测试用例转换为 Python 文件

ps:HttpRunner V3 以 Python 文件保存测试用例,V2 之前是以 JSON/YAML 格式保存测试用例

3、har2case

har2case 作用是将 HAR 格式的请求文件转为 YAML/JSON/Py 格式的测试用例

ps:一般网络请求都可以直接以 AHR 格式保存到本地

4、locusts

HttpRunner 集成了 locusts 命令,可以利用它直接进行性能测试

5、其他命令

另外,通过httprunner -h命令可以查看帮助;使用httprunner -V命令可以查看 HttpRunner 的版本信息


4.小试牛刀


先通过一个简单的接口聊聊 HttpRunner 的使用步骤

目标接口 - GET:

https://postman-echo.com/get?foo1=bar1

第一步:抓包,保存为 HAR 文件

打开 Charles 或 Fiddler,配置 Chrome 浏览器的代理, 使 Charles 可以对浏览器进行抓包

使用 Chrome 访问这个接口地址,模拟一次请求,然后在 Charles 中找到对应的请求,右键保存为 HAR 文件

Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_HttpRunner _02

第二步:转为测试用例

使用 har2case 命令将 HAR 文件转换为测试用例,V3 版本默认生成测试用例格式为 Py 文件
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_HttpRunner _03

查看测试用例后发现,HttpRunner 自动生成的测试用例结构十分清晰,二次修改也非常方便
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_Python_04

第三步,运行测试用例

使用 hrun 命令运行测试用例,另外,加上 --html 参数,可以在本地生成测试报告

# 生成测试报告hrun demo_test.py --html=report.html

打开测试报告,可以查看测试用例的执行结果及日志
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_HttpRunner _05


5.脚手架


HttpRunner 同样提供了脚手架,方便我们快速创建标准化项目

# 使用脚手架创建一个项目httprunner startproject demo

生成项目的目录结果如下:
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_Python_06

其中,

1、debugtalk.py

一般用于自定义 Python 函数,方便测试用例调用

比如:某个请求参数需要通过一段加密逻辑生成,这时可以自定义一个函数写在 debugtalk.py 文件中

2、har

从抓包工具、Postman、浏览器保存的网络请求

3、reports

生成测试报告的目录

需要指出的是,除了使用自带的 pytest-html 插件生成测试报告,HttpRunner 还可以通过 allure 生成功能更加强大的测试报告

4、testcases

用于放置测试用例

使用 hrun 命令可以直接运行脚手架项目

# 运行脚手架项目# hrun 项目名称hrun demo

6.最后


受限于篇幅,上面仅仅介绍了 HttpRunner 最基本的使用方法
Python如何使用 HttpRunner 做接口自动化测试——这些你一定不知道_Python_07