HTTPRunner是一种单元测试工具,由于教学的需求,我学习了它,但是我觉得它比Python的Requests类相差太远。作为一个比较流行的工具在这里进行介绍。
1,原理
HttpRunner 是一款开源的 API 测试工具,兼容 HTTP(S)、HTTP2、WebSocket、RPC 等多种网络协议,支持接口测试、性能测试、数字体验监测等多种测试类型。它操作简便,功能全面,拥有丰富的插件系统和卓越的扩展性。
功能特点:
- 全面支持网络协议:不仅完整支持 HTTP(S)/1.1 和 HTTP/2,还能灵活扩展至 WebSocket、TCP、RPC 等多种协议。
- 多样化的测试用例格式:支持 YAML、JSON、go test、pytest 等多种格式,且可轻松实现格式之间的转换。
- 双重执行引擎:集成了 golang 和 python 两种执行引擎,既保证了go 的高效性能,也享受了 pytest 丰富的生态系统。
- 便捷的用例生成方式:支持通过 HAR、Postman、Swagger、curl 等工具生成测试用例,同时提供基于链式调用的编写方法,简化测试用例的编写过程。
- 应对复杂测试场景:借助 variables、extract、validate、hooks 等机制,轻松构建复杂的测试场景。
- 插件化扩展:内置了丰富的函数库,并支持使用 go、python、java 等主流编程语言编写自定义函数,轻松扩展更多功能。
- 高效的性能测试:无需额外设置即可进行压力测试,单机轻松支持超过1万 VUM,配合分布式负载能力,可实现大规模压力测试。
- 网络性能监测:在进行场景化接口测试的同时,还能额外监测网络链路的性能指标,如 DNS 解析、TCP 连接、SSL 握手、网络传输等。
- 一键快速部署:通过二进制命令行工具分发,无需依赖特定环境,一条命令即可在 macOS、Linux、Windows 上迅速完成安装部署。
官方网址:
https://httprunner.com/
2,安装
1)使用pip安装
代码语言:javascript复制pip install httprunner
2)安装hrp命令
GitHub上下载安装包:
代码语言:javascript复制https://github.com/httprunner/httprunner/releases
选择合适的安装包
3)下载完成后,进行解压,加入全局变量中
3 使用
1)在工作目录中,终端执行命令,创建ebusiness项目
hrp startproject ebusiness
目录结构:
- har 录制的文件目录
- results 报告目录
- testcases 测试用例目录
- .env 环境配置文件
- .gitignore 传git仓库时忽略文件
- debugtalk.py 辅助函数功能文件
- proj.json 记录创建项目的信息
2)修改.env 环境配置文件
代码语言:javascript复制base_url=http://192.168.31.57:8000/
base_url为测试所需要的根目录
3)在testcases目录中建立测试用例test_ebusiness.yml。(在testcases目录下有多个示例用例,您可以删除)
代码语言:javascript复制#表示下面为配置段
config:
#测试主标题
name: 测试电子商务模块
#定义全局变量
variables:
#基础的URL
base_url: "http://127.0.0.1:8000"
#表示下面为测试用例段
teststeps:
-
#定义此用例名称
name: 登录首页
#请求参数
request:
#请求方法
method: GET
#URL地址
url: $base_url
#提取响应的数据并存储到变量中
extract:
#获取名为csrftoken的cookier参数
- csrftoken: cookies.csrftoken
validate:
#验证返回码是200
- eq: ["status_code", 200]
-
#定义此用例名称
name: 登录验证
#定义变量
variables:
#定义用户名
username: "cindy"
#定义密码,密码经过SHA256散列
password: "8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92"
#请求参数
request:
#请求方法
method: POST
#URL地址
url: $base_url/login_action/
#定义cookies参数
with_cookies:
csrftoken: $csrftoken
#定义头
headers:
X-CSRFToken: "$csrftoken"
#定义请求参数
data:
username: $ username
password: $ password
csrfmiddlewaretoken: "$csrftoken"
validate:
validate:
#验证返回码是200
- eq: ["status_code", 200]
- eq: [url, $base_url/goods_view/]
- eq: [encoding, utf-8]
- eq: [reason, OK]
HttpRunner 的测试用例由两个核心部分构成:
配置(config):这是测试用例的共享配置环节,涵盖了诸如用例名称、基础 URL、参数化数据源以及是否启用 SSL 验证等设置。
测试步骤(teststeps):这部分是一系列有序的操作步骤,其设计理念借鉴了 go interface,能够灵活支持各种协议和测试类型的扩展,甚至包括用户界面(UI)自动化测试。每个 step 都是一个 HTTP 请求,描述信息仅包含了 HTTP 请求和结果校验的核心要素。
变量的定义在step或config的variables中。
运行成功,产生pytest格式的python文件。
代码语言:javascript复制# NOTE: Generated By HttpRunner v4.3.5
# FROM: .testcasestest_ebusiness.yml
from httprunner import HttpRunner, Config, Step, RunRequest
class TestCaseTestEbusiness(HttpRunner):
config = Config("测试电子商务模块").variables(**{"base_url": "http://127.0.0.1:8000"})
teststeps = [
Step(
RunRequest("登录首页")
.get("$base_url")
.extract()
.with_jmespath("cookies.csrftoken", "csrftoken")
.validate()
.assert_equal("status_code", 200)
),
Step(
RunRequest("登录成功,进入商品页面")
.with_variables(
**{
"username": "cindy",
"password": "8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92",
}
)
.post("$base_url/login_action/")
.with_headers(**{"X-CSRFToken": "$csrftoken"})
.with_data(
{
"username": "$username",
"password": "$password",
"csrfmiddlewaretoken": "$csrftoken",
}
)
.validate()
.assert_equal("status_code", 200)
.assert_equal("url", "$base_url/goods_view/")
.assert_equal("encoding", "utf-8")
.assert_equal("reason", "OK")
),
]
if __name__ == "__main__":
TestCaseTestEbusiness().test_start()
可以通过pytest来运行这个测试用例
另:网上说可以通过
代码语言:javascript复制hrp run testcases/test_demo.yml --gen-html-report
运行,并且产生测试报告
代码语言:javascript复制hrp boom testcases/test_demo.yml --spawn-count 10 --spawn-rate 2
运行性能测试
我没有实现,据说要连接到google上
Httprunner测试用例可以用yam来写,也可以用json来写。