聊城网站设计,wordpress登录注册页面梅花,seo网址,长沙河西网站建设easytest
easytest 是一个接口自动化框架。
功能特点#xff1a; 支持 http 接口测试 支持 json#xff0c;html,xml 格式的响应断言 支持数据库断言 支持用例标记筛选 支持用例失败重运行 支持多线程
安装
pip install lemon_easytest
快速使用
不需要写任何代码…easytest
easytest 是一个接口自动化框架。
功能特点 支持 http 接口测试 支持 jsonhtml,xml 格式的响应断言 支持数据库断言 支持用例标记筛选 支持用例失败重运行 支持多线程
安装
pip install lemon_easytest
快速使用
不需要写任何代码所有你需要做的就是按照规则编写用例文档然后运行命令 easytest。
easytest 支持 yaml 格式和 excel 格式的用例文档。
在任意目录下创建文件 singe_test.yaml内容如下
test: # 表名这是单个测试用例title: 一个简单的测试 # 用例名称url: http://httpbin.org/get # urlmethod: get # 请求方法request: # 请求参数字段headers: # 请求头CustomerHeader: lemonban # 头信息params: # url参数search: lemonban # url参数键值对res_type: json # 响应数据类型status_code: 200 # 状态码assertion: # 断言表达式-- eq # 相等- $..Customerheader # 结果提取表达式- lemonban # 期望值-- eq- $..search- lemonban
如果你想学习自动化测试我这边给你推荐一套视频这个视频可以说是B站播放全网第一的自动化测试教程同时在线人数到达1000人并且还有笔记可以领取及各路大神技术交流798478386
【已更新】B站讲的最详细的Python接口自动化测试实战教程全集实战最新版_哔哩哔哩_bilibili【已更新】B站讲的最详细的Python接口自动化测试实战教程全集实战最新版共计200条视频包括1、接口自动化之为什么要做接口自动化、2、接口自动化之request全局观、3、接口自动化之接口实战等UP主更多精彩视频请关注UP账号。https://www.bilibili.com/video/BV17p4y1B77x/?spm_id_from333.337vd_source488d25e59e6c5b111f7a1a1a16ecbe9a 然后在命令行运行
easytest yourpath/single_test.yaml
INFO 2021-10-30 14:53:26,081 :single_test测试开始
INFO 2021-10-30 14:53:26,081 :用例【一个简单的测试】开始测试
INFO 2021-10-30 14:53:26,591 :用例【一个简单的测试】测试结束
INFO 2021-10-30 14:53:26,591 :single_test测试结束
用例总数:1,成功:1个,跳过:0,失败:0个,错误:0个
通过 python 代码调用 easytest
可以直接通过 python 调用 easytest
import easytest
easytest.main()
也可传递参数
easytest.main([test_dir, --debug, --logfile, test.log])
编写用例
测试用例
easytest 中编写单条测试用例可以使用 yaml 格式也可以使用 Excel 文件。
Excel 格式
使用 Excel 文件编写单条测试用例非常简单例如将上面的案例编写到 Excel 文件中格式如下! 当用 Excel 文件编写用例时保持数据的整洁其他单元格不要有任何数据以免加载用例数据失败。easytest 会根据 Excel 文件的 sheetname 来组织用例所以单条用例请删除其他的表。
YAML 格式
当使用 YAML 文件编写单条测试用例时最外层键必须为 test因为 easytest 根据它来确定一个 YAML 文件中的数据是单条测试用例。
test: # 表名这是单个测试用例title: 一个简单的测试 # 用例名称url: http://httpbin.org/get # urlmethod: get # 请求方法request: # 请求参数字段headers: # 请求头CustomerHeader: lemonban # 头信息params: # url参数search: lemonban # url参数键值对res_type: json # 响应数据类型status_code: 200 # 状态码assertion: # 断言表达式-- eq # 相等- $..Customerheader # 结果提取表达式- lemonban # 期望值-- eq- $..search- lemonban
测试套件
easytest 中测试套件表示一组有顺序的测试用例当启动多线程时以测试套件为单位交给线程去按照套件中的顺序执行测试用例。注意套件和套件间的执行顺序是不固定的。
单个测试用例也会被套上一层测试套件的壳子yaml 格式的单测试用例会被封装到以 YAML 文件名为名字的测试套件中Excel 格式的单测试用例会被封装到以表名为名字的测试套件中。
Excel 格式
Excel 文件中编写测试套件与单测试用例没有区别按照执行顺序从上往下依次编写即可例如 在单个 Excel 文件中可以编写多个测试套件一个表即为一个测试套件所以非测试用例或者项目设置的表请删除。
YAML 格式
在 YAML 文件中编写测试套件最外层的 key 必须为 test_suit因为 easytest 根据它来确定一个 YAML 文件中的数据是一个测试套件。注意和 Excel 不同YAML 格式不支持在一个文件中编写多个测试套件因为多层级的嵌套缩进将是噩梦。
test_suit:- title: 一个简单的测试url: http://httpbin.org/postmethod: poststatus_code: 200res_type: jsonrequest:json:username: xinlanpassword: 123456assertion:- [eq,$..username,xinlan]- [eq,$..password,123456]- title: 一个不简单的测试url: http://httpbin.org/postmethod: poststatus_code: 200res_type: jsonrequest:json:username: xinlanpassword: 123456assertion:- [ eq,$..username,xinlan ]- [ eq,$..password,123456 ] 用例收集规则
easytest 命令后接受一个位置参数 file_or_dir它可以是一个用例文件也可以是一个目录。
当传入一个用例文件时它必须是上一节提到的符合格式的 excel 或者 yaml 文件Excel 文件只支持 .xlsx 后缀的格式YAML 文件支持 .yaml 或者 .yml 后缀。
当传入一个目录时easytest 会递归的去这个目录下搜索所有符合规则的用例文件(excel、yaml)并从中提取用例当遇到格式错误时程序会中断所以不要把无关的 Excel 文件和 YAML 文件放在用例目录下。 用例字段说明 title 字符串用例标题 url 字符串请求的 url支持完整 url例如 https://httpbin.org/get也支持项目配置中的接口对应的 key。例如register method 字符串http 请求方法 request JSON 对象http 请求携带的参数请求头cookie 等。底层调用 python 的 requests 库参数名完全一致。 params JSON 对象http 请求携带的 url 参数。例如 request:params:search: python data JSON 对象http 请求携带的表单参数。例如 request:data:username: xinlanpassword: 123456 JSON JSON 对象http 请求携带的 JSON 参数。例如 request:json:username: xinlanpassword: 123456 headers JSON 对象http 请求携带的 header。例如 request:headers:X-Lemonban-Media-Type: lemonban.v1 cookie JSON 对象http 请求携带的 cookie 信息。例如 request:cookies:key: value res_type 字符串http 响应类型可选值有json,xml,html status_code 整数http 断言响应状态码。 assertion 数组对象响应结果断言表达式。格式为[[条件符号,提取表达式,期望结果],[条件符号1,提取表达式1,期望结果1],...]例如 assertion:- [eq,$..username,xinlan]- [eq,$..password,123456]
条件符号支持 eq: 相等 gt: 大于 gte:大于等于 lt: 小于 lte:小于等于 in:在其中 contains:包含
目前仅支持 eq
提取表达式支持 正则表达式 jsonpath 表达式 xpath db_assertion 数组对象数据库断言表达式。格式为[[条件符号,sql语句,期望结果],[条件符号1,sql语句1,期望结果1],...]例如
db_assertion:- [eq,select leave_amount from member where id#invest1_id#,0]- [exist,select id from invest where member_id#invest1_id# and loan_id#loan_id# and amount5000,true]- [exist,select id from financelog where pay_member_id#invest1_id# and amount5000 and pay_member_money0 and status1,true]
条件符号支持 eq: 相等exist: 存在。使用 exist 时期望结果必须为 true extract 数组对象响应结果提取表达式。格式为 [[变量名,提取表达式],[变量名2提取表达式2],...] 例如
exract:- [mobile_phone, $..mobile_phone]- [token, $..token] 底层 easytest 会将提取出的值绑定到用例类的变量名属性上供后面的用例依赖。 提取表达式支持 jsonpath 正则表达式 xpath 表达式 marks 字符串用例标记运行参数中可以筛选出匹配的标记用例
项目配置
easytest 命令会从当前目录下读取名为 easytest.ini 的配置文件下面是一个完整配置文件的例子
[project] # 项目配置段
name xxx项目 # 项目名称
host http://some.api.root.com # 项目接口根地址
[db_config] # 数据库配置
host dbhost # 数据库主机
user root # 数据库用户
password 123456 # 数据库密码
db somedb # 数据库名
charset utf8 # 字符编码
port 3306 # 端口
[interfaces] # 接口地址
register: /member/register # 注册接口对应地址
login: /member/login # 登录接口对应地址
withdraw: /member/withdraw
recharge: /member/recharge
add: /loan/add
audit: /loan/audit
invest: /member/invest
[run] # 运行时参数
debugtrue # 开启调试模式
logfilea.log # 日志文件
markssuccess,login # 筛选标记
thread_num10 # 启动线程数量
retry3 # 失败重跑次数
reportresult.json # 报告文件
project
project 段支持 name 和 host name 项目名称 host 项目接口根地址注意不要以 / 结尾 db_config
db_config 段数据库配置目前仅支持 MySQL host 数据库主机 user 数据库用户名 password 数据密码 db 数据库名 port 端口 charset 字符串编码 interfaces
interfaces 段接口名称配置格式keyvaluekey 是接口名称字符串value 是去掉主机后的接口地址以 / 开头在用例中 url 字段可以填写 keyeasytest 内部会使用项目 host 接口地址进行拼接。 run
run 字段运行时的参数。 debug 调试模式默认为 false logfile 生成日志文件可以是绝对路径或者是相对路径 marks 需要筛选的标记多个标记使用逗号隔开例如success,login表示会筛选被标记了 success 和 login 的用例。 thread_num 启动线程的数量默认为 0 表示单线程执行 retry 用例失败后重跑的次数默认为 0 表示不重跑 report 生成报告的文件名根据后缀自动生成对应报告暂只支持 JSON 格式。
注意命令行参数会覆盖项目配置。 生成模拟测试数据
在测试过程中有时需要动态的生成测试数据例如手机号码人名等。easytest 通过 Faker 模块来生产模拟数据暂时只支持简体中文语言下的接口详情见 Faker 简体中文 providers。
用例中支持生产模拟测试数据的字段有url,request,db_assertion。
使用格式为 $生成数据接口名$。
例如在 Faker 中生成手机号码的方法名为 phone_number那么在用例中使用 $phone_number$ 表示动态生成手机号码。 test: # 表名这是单个测试用例title: 一个简单的测试 # 用例名称url: http://httpbin.org/get # urlmethod: get # 请求方法request: # 请求参数字段headers: # 请求头CustomerHeader: lemonban # 头信息params: # url参数search: lemonban # url参数键值对phone: $phone_number$
上面这个用例表示 url 参数 phone 是一个动态生成的手机号码。 接口依赖的处理
easytest 中同一个测试套件下前一个用例返回的数据可以通过变量传递给下一个用例。
例如登录成功后将返回的 token 值传递给下一个需要 token 的用例。传递步骤如下 在登录用例中添加 extract 字段提取响应回的 token 值并绑定到你定义的变量名 admin_token 上 在后面的用例中在需要使用到 token 的数据部分就可以使用 #admin_token#来表示easytest 会在自动进行替换
所有你需要做的只是按照规则编写用例剩下的交给 easytest。 命令行参数说明 file_or_dir 字符串项目路径或者需要执行的用例文件 --debug 开启日志调试模式 --logfile 字符串日志文件路径 --marks
字符串运行时选择的标记 --thread_num 整数运行时启动线程的数量默认为 0 表示单线程执行 --report 字符串测试报告文件路径按照文件后缀生成对应的格式的报告
