httprunner框架（上）
一、什么是Httprunner？
1.httprunner是一个面向http协议的通用测试框架，以前比较流行的是2.X版本。
2.他的思想是只需要维护yaml/json文件就可以实现接口自动化测试，性能测试，线上监控，持续集成。
3.架构图
二、httprunner的设计理念
1.充分复用开源项目，不追求重复的造轮子，而是将市面上强大的轮子转成战车，降低框架的开发成本以及学习成本。
2.遵循约定大于临时配置的准则。（合同，考勤）
3.配置文件组织测试用例。
三、httprunner环境安装
1.python环境：3.6.2
2.安装httprunner：pip install httprunner
验证：hrun -V
3.必须知道的5个httprunner的命令：
httprunner：主命令，用于所有功能
hrun：用于运行yaml/json/pytest测试用例。
hmake：用于将yaml/json测试用例转化成pytest文件。
har2case：用于将har文件转化成yaml/json/pytest测试用例。
locusts：用于性能测试
四、httprunner快速上手
1.使用抓包工具：fiddler、charles操作一遍抓包。导出har文件。
2.通过har2case命令把har文件转化成yaml/json/pytest文件格式。
har2case get.har 生成pytest文件格式的测试用例
har2case get.har -2y 生成yaml格式的测试用例
har2case get.har -2j 生成json格式的测试用例
运行：
hrun get.yml
hrun get.json
hrun get_test.py
发现运行完成之后py文件里面的断言自动的去掉了，说明不管是运行yml、json其实最终都会重新成py文件运行。
五、YAML测试用例结构分析
每一个测试用例都是一个list of dict（字典列表）结构，其中包括config【配置】和teststeps【步骤】
[{},{},{}]
yml文件内容介绍：
cofig：配置
name：用例名称
variables:全局变量
：是否开启https验证
teststeps：步骤
name: /cgi-bin/token 步骤名称
request: 请求
headers: 请求头
Accept: '*/*'
Accept-Encoding: gzip, deflate, br
Cache-Control: no-cache
Connection: keep-alive
Host: api.weixin.qq.com
Postman-Token: 50f8bb1a-7826-49f8-835e-ec889063b7cc
User-Agent: PostmanRuntime/7.28.0
method: GET 请求方式
params: 请求参数
appid: wx74a8627810cfa308
grant_type: client_credential
secret: e40a02f9d79a8097df497e6aaf93ab80
url: https://api.weixin.qq.com/cgi-bin/token 请求路径
validate:断言
- eq:
- status_code
- 200
eq:
-headers.Content-Type
-application/json; encoding=utf-8
六、接口关联
在request标签下加一个extract标签提取返回值，通过content或body提取。
extract:
aaa: content.access_token
然后通过$变量名使用
params:
access_token: $aaa
七、动态参数：通过debugtalk.py的热加载的方式实现。
第一步：创建一个debugtalk.py文件，然后再里面写一个函数。
第二步：在yaml文件中通过${函数名()}的方式调用。
八、环境变量
开发环境，测试环境，线上环境。预发布环境。
在config下加入：
base_url:
九、全局变量
config下的variables是全局变量
teststeps:下的variables是局部变量
- name: /cgi-bin/tags/update
有两种写法：
1.换行的键值对
2.{}的方式
十、生成HTML格式的报告
hrun httprunners --html=httprunners/report.html
就是pytest里面pytest-html插件的报告一模一样。
httprunner框架（中）
一、httprunner常规的关键字详解
httprunner测试用例的结构
config：配置
name:名称
variables：全局变量
verify：https协议
base_url：环境变量
teststeps：步骤
name：步骤名称
request：请求
headers：请求头
method：请求方式
params：参数
url：请求路径
cookie:cookie信息
json:用于发送http请求正文
data:用于发送http请求正文
extract:提取（通过content或body提取，json提取器。支持正则表达式提取。）
validate：断言
eq相等
equals相等
str_eq（str(a)=str(b)）
lt：小于
le：小于或等于
gt：大于
ge：大于或等于
contains：包含
简化：
name：接口名称
request：请求
headers：请求头
method：请求方式
data：参数
url：请求路径
cookie:cookie信息
extract:提取（通过content或body提取，json提取器。支持正则表达式提取。）
validate：断言
equals相等
str_eq（str(a)=str(b)）
contains：包含
二、httprunner接口自动化项目架构
先要切换到项目的根目录，使用：httprunner startproject 项目名（没有虚拟环境）
har：存放har文件
reports：存放报告
testcases:存放测试用例
api：存放yml文件，接口定义。
data:数据驱动
testsuites：测试套件
.env：存放环境变量
.gitignore 当你的项目使用git做版本控制的时候，添加在此文件中的文件不会被git管理。
debugtalk,py实现热加载。
分层架构：三层
1.接口定义层（api）：为了更好的管理接口描述，每个一个接口定义都应该尽量的能够单独运行。
2.测试用例层（testcases）
3.测试套件层（testsuites）
关系：testcases调用api层（使用api关键字），testsuites调用testcases层（使用 testcase关键字）。
三、环境变量
环境变量可以写入.env文件
然后在api接口定义层里面使用：${ENV(变量名)}获取环境变量。
httprunner框架（下）
一、httprunner如何实现数据驱动
3.X开始，使用parameters定义数据源。应用于测试用例层。
第一种：直接在脚本里面指定参数列表，最简单。适合于参数比较少的情况。
1 config:
2 name: 测试用例
3 parameters:
4 appid‐grant_type‐secret‐assert_str:
5 ‐ ["wx74a8627810cfa308","client_credential","e40a02f9d79a8097df497e6aaf9
3ab80","access_token"]
6 ‐ ["","client_credential","e40a02f9d79a8097df497e6aaf93ab80","errcode"]
7 ‐ ["wx74a8627810cfa308","","e40a02f9d79a8097df497e6aaf93ab80","errmsg"]
8 teststeps:
9 ‐ name: 获得token鉴权码API
10 api: api/get_token.yml第二种：使用CSV文件，适合于参数较大的情况。
1 config:
2 name: 测试用例
3 parameters:
4 appid‐grant_type‐secret‐assert_str: ${P(data/get_token_data.csv)}
5 teststeps:
6 ‐ name: 获得token鉴权码API
7 api: api/get_token.ymlcsv文件内容：
1 appid,grant_type,secret,assert_str
2 "wx74a8627810cfa308","client_credential","e40a02f9d79a8097df497e6aaf93ab8
0","access_token"
3 "","client_credential","e40a02f9d79a8097df497e6aaf93ab80","errcode"
4 "wx74a8627810cfa308","","e40a02f9d79a8097df497e6aaf93ab80","errmsg"注意：
1.csv文件中第一行必须放参数名称，并且参数名称必须和测试用例里面的名称一致。
2.csv文件第二行放数据，每一组数据占一行。
3.parameters指定的参数顺序可以不一致，个数也可以不一致。
第三种：使用函数生成数据，适用于数据变化大的情况。
1 config:
2 name: 测试用例
3 parameters:
4 appid‐grant_type‐secret‐assert_str: ${get_token_data()}
5 teststeps:
6 ‐ name: 获得token鉴权码API
7 api: api/get_token.yml函数代码：
1 #生成数据
2 def get_token_data():
3 return [
4
{"appid":"wx74a8627810cfa308","grant_type":"client_credential","secret":"e4
0a02f9d79a8097df497e6aaf93ab80","assert_str":"access_token"},
5 {"appid": "", "grant_type": "client_credential", "secret": "e40a02f9d79a
8097df497e6aaf93ab80","assert_str": "errcode"},
6 {"appid": "wx74a8627810cfa308", "grant_type": "", "secret": "e40a02f9d79
a8097df497e6aaf93ab80","assert_str": "errmsg"}
7 ]二、httprunner文件上传
前提条件：需要安装如下两个包
pip install requests_toolbelt filetype
pip install "httprunner[upload]"
三、如何生成allure报告
第一步：
1.官网下载allure文件：Releases · allure-framework/allure2 · GitHub
2.下载之后解压到非中文的目录
3.把bin路径配置到系统变量path中：D:\BaiduNetdiskDownload\allure-2.13.7\allure-2.13.7\bin（注意分号不要是中文的）
第二步：
安装allure报告：pip install allure-pytest
验证：allure --version
注意：可能需要重启pycharm。
第三步：
1.在reports目录下生成temps目录，并且在temps目录下生产临时的json格式的临时报告。
1 os.system("hrun testsuites/test_suites.yml ‐‐alluredir=reports/temps ‐‐clean‐alluredir") 加上--clean-alluredir表示：每执行一次把原来的清除。
2.根据临时json报告生成allure报告
1 os.system("allure generate reports/temps ‐o reports/allures ‐‐clean") 加上--clean表示：每执行一次把原来的清除。
四、接口自动化框架文件对应关系
一个接口对应一个yaml文件，一个yaml文件对应一个csv文件。
优点：相对来说比较成熟，唯一的，不需要写脚本。
缺点：规则太难了，小心翼翼，报错机制不完善。有些功能不齐全。
