pytest + yaml 框架 - 1.我们发布上线了!

Posted 上海-悠悠

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了pytest + yaml 框架 - 1.我们发布上线了!相关的知识,希望对你有一定的参考价值。

前言

基于 httprunner 框架的用例结构,我自己开发了一个pytest + yaml 的框架,那么是不是重复造轮子呢?
不可否认 httprunner 框架设计非常优秀,但是也有缺点,httprunner3.x的版本虽然也是基于pytest框架设计,结合yaml执行用例,但是会生成一个py文件去执行。
在辅助函数的引用也很局限,只能获取函数的返回值,不能在yaml中对返回值重新二次取值。
那么我的这个框架,就是为了解决这些痛点。。。。

环境准备

Python 3.8版本
Pytest 7.2.0 最新版

pip 安装插件

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后直接运行

>pytest
======================= test session starts =======================
platform win32 -- Python 3.8.5, pytest-7.2.0, pluggy-1.0.0
rootdir: D:\\demo\\yaml_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

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内容

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": "\\r\\n    \\"username\\": \\"test\\",\\r\\n    \\"password\\": \\"123456\\"\\r\\n", 
  "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中取某一个值的问题

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用例规范

更多功能持续开发中…大家有好的建议想法也欢迎提出, 微信交流联系wx:283340479

以上是关于pytest + yaml 框架 - 1.我们发布上线了!的主要内容,如果未能解决你的问题,请参考以下文章

pytest + yaml 框架 -5.调用内置方法和自定义函数

pytest + yaml 框架 -7.用例分层机制

pytest + yaml 框架 -9.logging日志输出和保存

pytest + yaml 框架 -6.hooks 钩子功能实现

pytest + yaml 框架 - 2.extract 提取结果与接口之间的参数关联

pytest+yaml+allure接口自动化测试框架04.处理request