httprunner2.x工具快速入门
# httprunner2.x工具快速入门
HttpRunner是一款面向HTTP(s)协议的通用测试框架，只需编写维护一份 YAML/JSON 脚本，即可实现自动化测试、性能测试、线上监控、持续集成等多种测试需求。
下面我们用一个公共接口访问的案例，来讲述如何使用它来完成自动化测试case。大家可以参考一下
# 参考资料：
github地址：https://github.com/HttpRunner/HttpRunner v2x 用户手册：https://v2.httprunner.org/prepare/testcase-structure/
# 1.httprunner2.x编写case
# 1.1.项目由python编写，故需要下载python解释器
https://www.python.org/
# 1.2安装及创建项目
pip install httprunner==2.5.7 -i http://pypi.douban.com/simple --trusted-host pypi.douban.com
可以通过以下命令验证是否成功
hrun -V
# 1.3创建一个httprunner项目
首先cd到你想要创建项目的目录下面，然后通过下面的命令行创建项目
hrun --startproject tianqiAPI
hrun --startproject 项目名称
# 1.4摸清接口
# 1.5使用case模板进行修改
1.api目录是用来编写请求参数的位置，新建的项目中的api文件夹下都会有这样一个demo_api.yml
name: demo api
variables:
var1: value1
var2: value2
request:
url: /api/path/$var1
method: POST
headers:
Content-Type: "application/json"
json:
key: $var2
validate:
- eq: ["status_code", 200]
2
3
4
5
6
7
8
9
10
11
12
13
2.复制并修改该yml
name: 天气接口api封装
variables:
appid: 23035354
appsecret: 8YvlPNrz
request:
url: /api
method: GET
params:
version: v9
appid: $appid
appsecret: $appsecret
validate:
- eq: ["status_code", 200]
2
3
4
5
6
7
8
9
10
11
12
13
# name（必填）
指定api的名称，不写会报语法错误
# variables（可选）
指定测试用例的公共变量。每个测试步骤都可以引用未在步骤变量中设置的配置变量。换句话说，步骤变量比配置变量具有更高的优先级。
# request
这个关键字下辖请求相关的地址、方法、参数
method：可以填写GET\POST\PUT...,底层使用requests库来实现
params：专门针对GET请求，可以把参数写在params里。相应的还有 data 、json两种
validate：
-eq: [检查值,预期值]
是判断值两个值相等的检查点
3.testcases文件夹下的demo_testcase.yml
name: 天气接口api封装
variables:
appid: 23035354
appsecret: 8YvlPNrz
request:
url: /api
method: GET
params:
version: v9
appid: $appid
appsecret: $appsecret
validate:
- eq: ["status_code", 200]
2
3
4
5
6
7
8
9
10
11
12
13
4.复制并修改
config:
name: "测试免费的天气接口"
base_url: 'http://www.tianqiapi.com'
teststeps:
-
name: 第一个调用
api: api/tianqi.yml
extract:
- var: body.city
validate:
- eq: ["status_code", 200]
- eq: [$var,"北京"]
2
3
4
5
6
7
8
9
10
11
12
13
# config
下辖整个yml-case通用的设置
name：报告中显示的case名称
base_url：一般我们把ip/域名写在这
# teststeps
一个yml格式的case可以包含若干相关接口（例如：下单流程-登录接口→加购接口→下单接口→支付接口），其中每一个接口调用认为是一个step。
name：这一步骤的名称
api：引用api文件夹的哪一个接口封装
extract：提取响应中的值，供后续接口 或者 检查点使用
validate：case层的检查点，和api层叠加
# 2.调试运行
httprunner的命令行会简写为hrun
1.将命令行路径切换到项目路径
2.使用hrun 脚本相对路径 来执行测试
D:\mtongxue\PyWork\hrun2x_stu\tianqiAPI>hrun testcases\tianqi.yml
3.case执行完成后，会在reports文件夹生成一个报告
通过报告检查case编写是否成功
# 测试报告
