前言
基于 httprunner 框架的用例结构,我自己开发了一个pytest yaml 的框架,那么是不是重复造轮子呢? 不可否认 httprunner 框架设计非常优秀,但是也有缺点,httprunner3.x的版本虽然也是基于pytest框架设计,结合yaml执行用例,但是会生成一个py文件去执行。 在辅助函数的引用也很局限,只能获取函数的返回值,不能在yaml中对返回值重新二次取值。 那么我的这个框架,就是为了解决这些痛点。。。。
环境准备
Python 3.8版本 Pytest 7.2.0 最新版
pip 安装插件
代码语言:javascript复制pip install pytest-yaml-yoyo
第一个 helloworld
yaml 用例编写规则,跟pytest识别默认规则一样,必须是test 开头的,以.yml
结尾的文件才会被识别
新建一个test_hello.yml
文件
config:
name: yy
teststeps:
-
name: demo
print: hello world
用例整体结构延续了httprunner框架的用例结果,主要是为了大家快速上手,减少新的规则学习
- config 是必须的里面必须有name 用例名称,base_url 和 variables 是可选的
- teststeps 用例的步骤,用例步骤是一个array 数组类型,可以有多个步骤
从上面的运行可以看出,request 不是必须的,我们可以直接调用python内置函数print 去打印一些内容了。
一个简单的 http 请求
以http://www.example.com/
get 请求示例
test_get_demo.yml
config:
name: get
teststeps:
-
name: get
request:
method: GET
url: http://httpbin.org/get
validate:
- eq: [status_code, 200]
命令行输入pytest后直接运行
代码语言:javascript复制>pytest
======================= test session starts =======================
platform win32 -- Python 3.8.5, pytest-7.2.0, pluggy-1.0.0
rootdir: D:demoyaml_yoyo
plugins: yaml-yoyo-1.0.1
collected 2 items
test_get_demo.yml . [ 50%]
test_hello.yml . [100%]
======================== 2 passed in 0.49s ========================
再来一个post请求
test_post_demo.yml
代码语言:javascript复制config:
name: post示例
teststeps:
-
name: post
request:
method: POST
url: http://httpbin.org/post
json:
username: test
password: "123456"
validate:
- eq: [status_code, 200]
- eq: [headers.Server, gunicorn/19.9.0]
- eq: [$..username, test]
- eq: [body.json.username, test]
validate校验
比如返回的response内容
代码语言:javascript复制HTTP/1.1 200 OK
Date: Wed, 23 Nov 2022 06:26:25 GMT
Content-Type: application/json
Content-Length: 483
Connection: keep-alive
Server: gunicorn/19.9.0
Access-Control-Allow-Origin: *
Access-Control-Allow-Credentials: true
{
"args": {},
"data": "{rn "username": "test",rn "password": "123456"rn}",
"files": {},
"form": {},
"headers": {
"Content-Length": "55",
"Content-Type": "application/json",
"Host": "httpbin.org",
"User-Agent": "Fiddler",
"X-Amzn-Trace-Id": "Root=1-637dbd11-7d9943ba1fb93a9331f6cf8d"
},
"json": {
"password": "123456",
"username": "test"
},
"origin": "198.187.30.113",
"url": "http://httpbin.org/post"
}
校验方式延续了httprunner的校验语法,可以支持response取值对象:status_code, url, ok, headers, cookies, text, json, encoding 其中返回的是json格式,那么可以支持
- jmespath 取值语法:
body.json.username
- jsonpath 语法:
$..username
- re 正则语法
如果返回的不是json格式,那么可以用正则取值
变量的声明与引用
变量的声明,只支持在config 声明整个yml文件的全局变量(不支持单个step的变量,减少学习成本)在httprunner里面变量引用语法是user, 引用函数是{function()}我这里统一改成了一个语法变量引用{var} 和 引用函数{function()}(表面上没多大变量,实际上功能强大了很多,使用了强大的jinja2 模板引擎)可以在引用函数后继续对结果操作, 这就解决了很多人提到了函数返回一个list,如何在yaml中取某一个值的问题
代码语言:javascript复制config:
name: post示例
variables:
username: test
password: "123456"
teststeps:
-
name: post
request:
method: POST
url: http://httpbin.org/post
json:
username: ${username}
password: ${password}
validate:
- eq: [status_code, 200]
- eq: [headers.Server, gunicorn/19.9.0]
- eq: [$..username, test]
- eq: [body.json.username, test]
运行结果
其它功能
目前第一个版本只实现了一些基础功能,还有接口的提取extract功能还未实现。 后续计划: 1、完善extract功能 2、实现多个接口步骤的参数关联 3、结合 allure 生成报告 4、辅助函数功能使用 5、yaml 中调用 fixture 功能实现 6、全局使用一个token,仅登录一次,完成全部用例测试 7、对yaml数据格式校验 8、添加日志 9、新增另外一套yaml用例规范
更多功能持续开发中….大家有好的建议想法也欢迎提出