PPL-Tester
简介
http工具集,通过代理获取到API的请求与响应信息,将这些请求信息进行流量回放/锲约测试或快速生成用例, 亦可通过人工进行修改参数化提取、变量引用、断言等形成API自动化测试用例等!
你以为只是流量回放吗?错~走去瞧瞧v2版本!
看官~请记得给个star呗?
项目地址:
github
gitee
功能介绍
流程图 (简陋ing···)
ps:
1、作者 Windows exe 运行,其它系统可自行打包或以 Python ppl x 执行.
2、运行程序需要在项目根目录下运行…
需要安装Python3环境及依赖库:
pip install -r requirements.txt
1、proxy http
command: ppl.exe f (python ppl.py f)
2023-01-20 10:39:53.628 | INFO | __main__:cmd:37 - run:http flows cat. exit:Ctrl+C
2023-01-20 10:39:53.642 | INFO | utils.flows:cat_mock_load:25 - loaded mock*.json match to will mock!
2023-01-20 10:39:53.644 | INFO | utils.flows:__init__:114 - Proxy server listening at http://0.0.0.0:8888
基本代理等使用请参阅博文:点击跳转
官方文档:https://docs.mitmproxy.org/stable
中文文档:https://ptorch.com/docs/10/mitmproxy_introduction
2、mock http response
可对 response 进行mock!
2.1 配置 config.ini
mock = ON
mock ON :开启mock
mock OFF:关闭mock
mode = ON
mode ON :向远程服务器发送任何数据,且根据mock数据交集返回数据从而响应
mode OFF:不向远程服务器发送任何数据
2.2 mock文件格式:mock*.json
2.3 随机参数引用格式:${faker}
结合 faker 的方法进行随机模式,文档请参考:https://faker.readthedocs.io/en/master/providers/faker.providers.python.html
mock demo:
{
"api/user/info": {
"bool": "${pybool}",
"name": "${name}",
"int": "${pyint}",
"float": "${pyfloat(0,1)}",
"data|1-3": [
{
"name": "${name}"
}
]
}
}
mock demo 输出
3、http flows replace
request 正则替换支持替换(headers url body cookie)
replace = {"pattern":"value","pattern1":"value1"}
使用场景:
1.鉴权:将 token 设置为空,如:
replace = {"old token xxx":""}
2.越权:将 token 设置为另用户token,越权又分为①水平越权(同角色)②垂直越权(向上级),如:
replace = {"old token xxx":"new token xxx"}
3.流量转发, 将test环境的前端去访问正式环境的数据(前端问题复现)
{"old host":"new host"}
PS:因前端本就发出 old host 请求,所以前端看到请求还是 old host 但真实是请求到 new host.
4、https证书过期检测
config.ini -> check_ssl hosts
check_ssl = app.xxx.com,web.xxx.com
command:
ppl.exe s
5、api playback
5.1 接口用例集合获取
方式1:Fiddler
1、将项目下desc/fiddler.txt
复制文本粘贴,FiddlerScript
2、更改为符合自己业务领域配置,是项目绝对路径app
目录,注意要用两个扛\\
方式2(推荐):mitmproxy
1、将项目下config.ini
过滤域名改为自己需要配置的域名以及业务领域,如果填写db_url则流量信息直接入库
2、需要配置代理证书等,详看mitmproxy使用文档
3、运行
command:
ppl.exe f
以上方式1及方式2 会得到txt文件 或直接入库
如果基于方式2(mitmproxy),配置db_url可直接流量入库回放测试.
1、你会得到:./data/api-xxx.txt 或 fiddler-xxx.txt
2、如需要用例入库,则执行命令行:
ppl.exe --play=0
另外可能需要进行数据库连接配置./config.ini.db_url
,默认为sqlite
mysql:db_url = mysql+pymysql://root:123456@127.0.0.1:3306/tester?charset=utf8
数据迁移:ppl.exe --move=new_db_url
5.2 执行测试
命令行参数说明(部分可在pytest.ini下默认配置),与pytest框架一致,并且新增以下参数:
-
–env:查询业务领域=ppl及环境=test的用例
如:--env=ppl,test
-
–param:附加将version参数替换为1或追加
如(Windows):--param={\"version\":\"1\"}
-
–file:读取app目录下所有txt文件进行流量回放,详细使用看流量回放
如:--file=1
-
–play:读取txt文件进行用例入库
如:–play=00:读取txt用例入库 1:读取db用例进行回放测试 2:读取txt文件流量回放 3: 读取阿里云日志流量并入库
-
–init:db表结构初始化,一般不需要用到
如:–init=1
方式1:txt文件流量回放
ps:不支持下载/上传文件回放,不要将txt文件换行或格式变化哦(只回放API响应码为200)
1)方式1:默认为app目录下全部txt文件(以下2-3不存在文件时亦是):pytest --file=1
2)方式2:指定app目录下的文件:pytest --file=fiddler_2022-7-31.txt
3)方式3:绝对路径指定文件(注意win下需要\\):pytest --file=E:\\fiddler_2022-7-31.txt
4)方式4:相对路径指定文件:pytest --file=./fiddler_2022-7-31.txt
方式2:经过用例入库,执行db用例测试
需要先配置 pytest.ini(推荐) 或 config db在进行运行.
详情查看 5.6 db或pytest config说明.
配置pytest.ini,作用与db用例映射执行对应环境测试.
ppl.exe --env=domain,env --param={\"version\":\"1\"}
ps:Windows可以生成allure报告:ppl.exe r (支持替换变量,存储变量,引用变量,响应断言)
5.3 后置处理器介绍:http_collect
参数提取器,默认是取第1个值(支持提取response与headers接口的返参)
Jsonpath语法请参考:https://goessner.net/articles/JsonPath
1.Jsonpath 区分大小写
1)获取key的值:['key'] ----> {'key':'value'}
2)获取key的值并重新命名:[{'key':'name'}] ----> {'name':'value'}
3)获取key的值并指定取第n个:['key':n] ----> {'key':values[n]}
4)获取key的值并重新命名及指定取第n个:['key':['name',n]] ----> {'name':values[n]}
5)原生Jsonpath语法:['$.data.key'] ----> {'key':'value'}
6)原生Jsonpath语法并重新命名:[{'$.data.key':'name'}] ----> {'name':'value'}
7)原生Jsonpath语法并指定取第n个:[{'$.data.key':n}] ----> {'key':values[n]}
8)原生Jsonpath语法并重新命名及指定取第n个:[{'$.data.key':['name',n]}] ----> {'name':values[n]}
2.正则表达式
1)获取正则表达式的值并命名为env:[{'re':['env','http://(.+?)/']}] ----> {'env':'value'}
2)获取正则表达式的值并命名为env及取第n个值:[{'re':['env','http://(.+?)/', -1]}] ----> {'name':'value'}
5.4 断言使用介绍:http_assert
1.Jsonpath 断言
1.字符在里面:[“msgId”]
`实际为:assert "msgId" in response.text`
2.变量在里面:[“${msgId}”]
`实际为:assert "${msgId}" in response.text`
2.字符相等:[{“msgId”:“123456”}]
`实际为:assert 123456 == json_path(result.json(), 'msgId')`
3.字符在里面or其它:[{“msgId”:[“123456”,“in”]}] 注:in 可以是== != not in
`assert 123456 in response.get('msgId')`
4.长度:1 == len(response.get(‘msgId’)):[{“msgId”:[1,“len”]}]
`assert 1 == len(response.get('msgId'))`
2.正则表达式断言
1.直接写正则表达式即可,如:[{'re':'http://(.+?)/'}]
5.5 变量引用(参数化关联)
使用本系统且遵循Faker语法直接引用:${Faker语法}
ppl_开头,为自定义生成数据方法
Faker 更多请查阅官方文档:https://faker.readthedocs.io/en/stable/locales/zh_CN.html#faker-providers-address
字段数据结构及解释,亦可查阅代码model:
1.号码相关:
1)手机号:${phone_number}18520149907
2)身份证号码:${ssn}410622198603154708
2.时间日期相关
1)当前日期时间:${ppl_now_datetime}2022-07-02 12:56:58
2)当前时间戳:${ppl_time}1656737818
3)当前日期:${ppl_now_date}2022-07-02
4)当前时间:${ppl_now_time}12:56:58
5)过去7天的日期时间:${ppl_datetime(-7)}2022-06-25 00:00:00
6)未来7天的日期时间:${ppl_datetime(7)}2022-07-09 23:59:59
7)随机年-月-日:${date}1996-03-20
8)随机(时:分:秒):${time}04:52:23
9)未来的日期时间:${future_datetime(end_date=+7d)}2022-07-07 16:01:23
10)过去的日期时间:${past_datetime(end_date=-7d)}2022-06-29 13:29:20
3.名字相关:
1)姓名:${name}王凯
2)姓名(女):${name_female}戴丽丽
3)姓名(男):${name_male}刘荣
4)姓:${last_name}宋
5)名字:${first_name}强
4.地址相关
1)地址:${address}香港特别行政区大冶县上街钟街k座 664713
2)省:${province}河北省
3)市:${city}长春县
4)地区:${district}白云
5)街道地址:${street_address}武汉街D座
5.6 db或pytest config说明
使用pytest.ini
.tester
配置 或 db config表配置,配置一种即可。
推荐使用pytest.ini
账号环境配置
1、pytest.ini 例子(需要压缩json,不可格式化)
[test]
tester = {"gray":"gray","Tester":[{"https://blog.csdn.net":{"url":"/qq_42675140","body":{},"method":"GET","collects":["ppl_cookie"]}},{"http://open-ppl-getaway.com":{"Authorization":"Bearer ","key":"nf9vMghQLyEZkeyxxxxx0ln9klsPz","secretx":"ylJhZzwvaa2NxxxsecretlDtNsJSyMh"}}],"filter_code":{},"filter_path":["/user/logout","/user/login"]}
[test]:表示定义的环境 test,可以多个.
tester:pytest 账号登录/过滤等配置
1) gray:默认gray就好,一般用于AB测试模型则需要配置.
2) Tester:登录获取token或cookie初始化,可配置多个登录信息
collects:表示后置处理器 collect (使用详细查看第三点[后置处理器使用]),用例提取token或cookie作为登录态
3) filter_code:过滤某些接口响应内容,可不写
4) filter_path:过滤某些接口url,一般用于过滤登录及退出登录以免执行测试时影响登录态
2、db config如下例子, 直接复制粘贴保存即可(可格式化):
{
"gray":"gray",
"Tester":[
{
"https://app-xxx.com":{
"url":"/api/user/login",
"json":{
"mobile":18888888888,
"Password":"mVs6NwvIFRgN0aaUo4KZOiW9QZWbKZjqVX1eW9Gr2s4rgZ5atS3ppY39ZlyE37Tb2/zo6YWJV6VJV="
},
"method":"POST",
"collects":[
"clienttoken"
]
}
},
{
"https://web-xxx.com":{
"url":"/api/index.php?r=data/login",
"data":"user=admin&password=4076f862096d1536b6cac6866e386655=",
"method":"POST",
"headers":{
"content-Type":"application/x-www-form-urlencoded"
},
"collects":[
"ppl_cookie"
]
}
}
],
"filter_code":{
"$response_key":[
200,
"200"
]
},
"filter_path":[
"/api/user/logout",
"/api/user/login"
]
}
5.7 mysql等断言
待开发文章来源地址https://www.toymoban.com/news/detail-759790.html
6、web页面管理用例等
待开发文章来源:https://www.toymoban.com/news/detail-759790.html
7、flows客户端,集成以上功能…
待开发
如有建议/疑问请联系我:https://blog.csdn.net/qq_42675140
到了这里,关于python3-API流量回放/锲约测试/自动化测试的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!