一天,你的领导X要你对某接口做测试,你一听,接口测试,高大上。用什么做好呢?postman?jmeter?loadrunner?balabala。。。优秀的你,想到了一大堆工具,当然也包括用python写。为了凸显B格,你选择了python。新建一个a.py文件,然后一顿猛如虎的撸代码:
import requests
url = “******”
params = "******"
re = reqeste.get(url, params)
...
你家X领导,一看,还行,提醒你少了断言,于是你加进去了
... assertEqual (content.msg, "***") ...
你家领导X可能是比较关心你,于是又丢了几个接口给你,你开始依葫芦画瓢,流水账代码搞起。但仔细想想,不对,于是你将每个请求都封装起来,大概长这样:
def qingqiu_a(): url = "***" ... def fangwen_b(): url = "***" ... def shenmegui_c(): url = "***" ...
显然,你的领导X是爱你的,某天他又丢给你几十个接口,然后希望你输出报告。你内心:“exm?”,改改改。于是你引入了unittest单元测试框架、HTMLTestRunner等等。
正打算将各个测试用例分类重新规整,你领导又来了。如果世界上有真爱这种东西存在的话,那你领导对你的爱便是了。
”我又从开发那里帮你要了100个接口过来测,开不开心?“
“你的脚本给我看下,这个是啥意思?可以在我那边运行吗?”
“你的脚本怎么这么多啊,好乱啊”
“这个接口我要做性能测试,还有这个、这个。。。“
”这几个接口是串联起来的,你处理下“
......
你几近崩溃,为什么,为什么不能简单点。
幸好,你并没有放弃,你在某个机缘巧合下发现了一个叫httprunner的测试框架,这个框架使用的是yaml格式的文本来描述脚本,一行命令即可执行接口测试,再来一行命令即可进行性能测试。在连夜研究完这个框架后,你发出一声惊叹:”原来接口测试可以这么优雅的写啊!“
于是你将几百个接口丢进一个文本里,需要压测的放在另外的文本里,你执行了两条命令:
hrun api.yml
locusts ya.yml
刷刷刷,搞定,X吃惊的看着你,似乎在看一头变帅的猪
”这次咋这么快?平时光调试不得一两天。“
”测试报告不错“
”数据也都校验了“
”压测也做了“
......
so,你是怎么使用httprunner的呢?开始还原现场。
0,安装
安装了python3的话,直接pip install httprunner即可(不推荐使用python2)
hrun -V 查看版本
hrun -h 查看帮助信息
1,用例格式
通常一个脚本文件里面有如下模块:
- config
- test
- test
即:全局配置、用例、用例
config模块里面定义的是整个文本测试集的变量,即全局变量
test模块里面定义的是具体接口请求,下面看个具体例子
2,举个例子
- config: name: test kuaidi100 api # parameters: # - user_id: [1001, 1002, 1003, 1004] request: base_url: http://www.kuaidi100.com - test: name: test kuaidi100 one request: url: /query method: GET params: type: huitongkuaidi postid: 350757858666
yaml格式类似与json,可以看成是优雅的json。yaml中,跟python一样,也是空格缩进表示同一层级,不过没有python那么严格,只要缩进空格数一样就是同一级,“-”python读取出来是list,“#”用来注释,这些其实已经够用了,更多用法可以去官网学习。
先看config模块里面
name 本用例集名称
parameters 全局参数,示例中注释掉了
request 请求全局变量,包括base_url(公共host)、headers等
base_url 全局公共host,也可以不定义,用例中写全url即可
以上全局配置,除了name,其他都是非必要的,根据需要添加。
test模块
name 本条测试用例的名字
request 请求体
url 请求的路径,由于全局变量已经定义好host,这里就直接填写后面的路由即可
method 请求方式
params 请求参数
示例是某快递查询接口,脚本初步写好,接下来开始测试吧,怎么测试脚本?
打开cmd,进入到该文件目录,执行命令hrun test_post_api.yaml回车即可。
成功,cool,可以看到一条用例测试通过,而且还在当前目录生成了report文件夹,测试报告就放在里面,报告名字由测试时间戳生成。
点击log,可以查看详细日志
3,断言
虽然运行成功,但还是不够,我们无法判断请求的结果对不对,与我们的预期是否一致。这个时候就需要断言。httprunner中断言很简单,通过增加validate参数,如下:
那么怎么知道如何定义被断言的数据呢?即上图中的content.message等。
浏览器执行该接口,其返回值是字典,可以直接通过content后面接“.key”获取value值,如content.message断言值设置为“ok”,如果其对应的value等于“ok”,就表示通过。
{"message":"ok","nu":"350757858666","ischeck":"1","condition":"F00","com":"huitongkuaidi","status":"200"......
加好想要的断言后,再次执行用例,打开报告查看日志,可以看到,日志里面清楚的记录了所以的断言结果。
4,参数传递
在做接口测试,经常需要将上一个接口返回的结果,传入到下一个接口中当着参数,httprunner中使用extration参数来进行参数的传递。由于演示接口只有一个,就让第一条用例的返回值,传入到第二个用例中当做参数,正好返回值里面有运单,直接拿来用
- config: name: test kuaidi100 api # parameters: # - user_id: [1001, 1002, 1003, 1004] request: base_url: http://www.kuaidi100.com - test: name: test kuaidi100 one request: url: /query method: GET params: type: huitongkuaidi postid: 350757858666 validate: - eq: [status_code, 200] - eq: [content.message, "ok"] - eq: [content.com, "huitongkuaidi"] - eq: [content.nu, "350757858666"] extract: - postid: content.nu - test: name: test kuaidi100 two request: url: /query method: GET params: type: huitongkuaidi postid: $postid validate: - eq: [status_code, 200] - eq: [content.message, "ok"] - eq: [content.com, "huitongkuaidi"] - eq: [content.nu, "350757858666"]
从返回值中获取内容,上面刚讲就不赘述,后面需要传递参数是,直接在变量前面加上$即可。执行测试,通过,cool:
5,脚本运行方式
单个脚本可以使用:hrun ***.yaml
多个脚本直接指定文件夹:
6,性能测试
httprunner集成了locusts性能测试工具,与接口测试命令类似,直接执行:locusts -f test_post_api.yaml即可
7,参数化
诚然,无论在日常接口测试,还是性能测试,都对数据有要求,特别是性能测试,需要大量数据,这个时候就需要对传递的参数进行参数化了。
httprunner中支持的参数化方法有:csv文本、自定义函数
好困,明天再写这些。晚安。