当前位置： 首页 > news >正文

2022/9/5开始第三版接口自动化（yaml用例）测试框架（记录搭建过程）

news 来源：原创 2024/5/5 22:52:23

序章

第一代框架

源码地址
教程
在这里插入图片描述

第二代框架

源码地址
搭建教程
使用教程
在这里插入图片描述

一、yaml用例设计

这个模板不代表最终模板，后续可能还有改动

#用例(名称)标题，需要参数依赖的全部设置字符格式，后期解析成字典列表等格式
用例标题:
  #接口地址，也支持参数依赖
  path: /test/$.id
  #请求方法
  method: post
  #有值就用这个，没用就使用默认配置的，有header里面使用参数依赖的场景
  header: {}
  # 是否运行
  is_run: True
  # 前置sql：sql有2大类，一个是查询有返回值，一个是增删改无返回值，前置sql为无返回值类型
  precondition_sql:
    - UPDATE case_test SET title = '标题2', ex = '44' WHERE id = 2
    - UPDATE case_test SET title = '标题3', ex = '55' WHERE id = 3
  #请求参数较多，这里就使用原始字典格式，除了提取表达式，其他的都带上引号，预防出错,random_time()随机函数使用
  data:
    {
      "id":$.id,
      "projectNo": "320SF000206004",
      "name":$.name,
      "time": random_time(),
      "str": random_str(6),
      "int": random_number(5),
      # 请求参数sql为有返回值查询
      "sql": sql-SELECT title FROM case_test where id=2
    }
  #参数类型 json 或者 form表单
  data_type: json
  #从接口返回结果提取哪些字段和提取表达式,比如从返回数据提取用户id和name
  extract_key:
    id: $.id
    name: $.name
  #断言表达式
  # 除了数字类型比较，其他的字符或者表达式全部带上引号,表达式必须要写在后面（必须按照格式来）
  # 断言sql为有返回值查询
  assert_expression:
    #判断响应码是否和预期一致
    code: 200
    #判断预期值是否在返回值里面（用值是否在接口返回的内容里面判断）
    body: 内容包含
    #判断json提取值是否和预期一致（用键和值比较等于，大于小于或者in判断）
    json:
      {"ig" : ">$.ig","rng" : "==$.rng","edg" : "<$.edg",'1':'in$.ig'}
    #判断sql查询值是否和预期一致（用键和值作判断，规则和上面一致）
    sql:
      {'1':">sql-SELECT title FROM case_test where id=2",'2':"==sql-SELECT title FROM case_test where id=2"}

二、配置哪些字段需要字符化

‘header’,‘data’,'assert_expression’这三个字段是需要参数依赖的，要让它们被读取处理时先转成字符格式，方便后续使用.replace()替换方法，替换完后使用eval()方法去除字符恢复原来的格式
在这里插入图片描述

三、用例读出

yaml读出方法基本和第二版无改动
文件目录排除做了一些修改，增加了一个raw_case_path用例所属文件夹的配置
用例读取的方法进行了重构
增加了把用例的某些字段字符化的处理，用例的格式也变成了列表嵌套字典的格式
在这里插入图片描述

#!/usr/bin/env python
# -*- coding: utf-8 -*-
'''
@time    : 2022/9/5 
@Author  : LL
@File    : read_file.py
'''
import os
from pathlib import Path
from config.config import exclude_file,exclude_dir,raw_case_path,str_zd
import yaml


class ReadFile:
    # D:\python2022\yaml_pytest_drf_vue/
    project_directory = str(Path(__file__).parent.parent) + '/'

    @classmethod
    def read_yaml(cls, path):
        '''读取yaml文件，以字典格式返回{'用例标题':{'path':'/test','data':{'id':1}}}'''
        try:
            path = cls.project_directory + path
            file = open(path, 'r', encoding='utf-8')
            with file as doc:
                content = yaml.load(doc, Loader=yaml.Loader)
                return content
        except Exception as e:
            # logger.error(f'读取{path}文件出错:{e}，检查文件内容格式是否错误')
            print(f'读取{path}文件出错:{e}，检查文件内容格式是否错误')

    @classmethod
    def file_execute_list(cls, exclude_file=exclude_file, exclude_dir=exclude_dir,raw_case_path=raw_case_path):
        '''
        :param exclude_dir: 要排除的目录（二级目录）
        :param exclude_file: 要排除的文件（case目录下所有文件）
        :param raw_case_path: 用例原始文件总目录
        :return: 获取case下的所有用例文件列表,最多支持二级目录,通用排除文件返回最终要执行的用例文件
        '''
        file_list = []
        case_path = cls.project_directory + raw_case_path
        # case目录下的所有文件
        for filename in os.listdir(case_path):
            if 'yaml' in filename:
                # 要储存为case开头的目录，方便读取用例使用
                file_list.append(raw_case_path + filename)
            else:
                # 遍历case下面的二级目录
                for i in os.listdir(case_path + '/' + filename):
                    # 检查这个二级目录是否需要被排除
                    if filename in exclude_dir:
                        continue
                    # 要储存为case开头的目录，方便读取用例使用，这是二级目录得把二级目录拼接上
                    file_list.append(raw_case_path + filename + '/' + i)
        # 文件列表不为空的话一个一个的排除掉这些文件
        if exclude_file != []:
            for i in exclude_file:
                file_list.remove(i)
        return file_list

    @classmethod
    def read_case(cls):
        '''最终返回列表嵌套字段的用例格式'''
        #读取用例要执行的列表
        path_list = cls.file_execute_list()
        case_list=[]
        for i in path_list:
            #i就是单yaml文件路径，然后读出来放到用例列表里面
            case=cls.read_yaml(i)
            # print(case)
            for k,v in case.items():
                #由于yaml是以用例标题为键，直接赋予名字,然后把标题加到主体里面去
                case_title=k
                case_body=v
                #这里面有需要字符化的字段,字典，列表等全部转成字符串
                # data_d = type(case_body['data'])
                # print(f'测试下数据是不是转化成功-转换后类型{data_d}')
                for str_z in str_zd:
                    try:
                        case_body[str_z]=str(case_body[str_z])
                    except KeyError as e:
                        print(f'用例无字段{e}')
                case_body.update({'case_title':case_title})
                # data_s=type(case_body['data'])
                # print(f'测试下数据是不是转化成功-转换后类型{data_s}')
                #判断用例是否需要运行
                if case_body['is_run']==True:
                    #最后把case_body加入到case_list里面
                    case_list.append(case_body)
        return case_list



if __name__ == '__main__':
    case = ReadFile.read_yaml('raw_case_file/test.yaml')
    # print(type(str(case['用例标题']['data'])))
    # print((str(case['用例标题']['data'])))
    print(ReadFile.file_execute_list())
    ReadFile.read_case()

四、requests二次封装

对比第二版的requests二次封装进行了重构，添加支持get请求传参，支持form表格和json传参，增加put和delete方法
在这里插入图片描述

五、pytest基本使用配置

pytest运行命令，详细展示运行详情，生成报告数据到./report/data目录

addopts = -vs --alluredir ./report/data

设置要运行用例文件的路径，我这里就一个文件，指定个目录就行

testpaths = case_run

在这里插入图片描述
简单的一个主方法，可以看到控制台打印出了三条用例数据，把从yaml文件里面读取的用例使用parametrize参数化
在这里插入图片描述

六、参数提取和替换

参数替换：相比于第二代重构了这个方法，替换是先把要替换的数据字符化，然后通过正则查找到需要替换的数据，然后去参数池里面取到，替换到原数据中，最后解除字符化，变为原来的格式
参数提取：把提取表达式转化为具体的值，把提取的值保存到参数池里面

#!/usr/bin/env python
# -*- coding: utf-8 -*-
'''
参数替换使用正则表达式，参数池格式为${}，函数格式为f{}，提取使用jsonpath
'''
from jsonpath import jsonpath
import re

class ParameterSetting:
    # 参数池
    access_value = {}

    @classmethod
    def data_is_replace(cls, data):
        '''
        :param data: 请求参数data和提取参数extract_key
        :return: 请求参数是否需要被替换
        '''
        if data is None:
            return False
        for k, v in data.items():
            if '&{' in v or 'f{' in v:
                return True
        return False

    # 基于jsonpath表达式提取
    @classmethod
    def extract(cls, api_response: dict, extract_key: dict):
        '''
        :param api_response: 接口返回值 例：{'code':200,'content':{'bill':'ys123456'}}
        :param extract_key:  提取表达式 例：{'bill': '$.content.bill'}
        '''

        extract_value = {}
        # 把提取表达式转化为具体的值 例：{'bill': 'ys123456'}
        for k, v in extract_key.items():
            extract_value[k] = jsonpath(api_response, v)[0]
        # 把提取的值保存到参数池里面
        for k, v in extract_value.items():
            cls.access_value[k] = v

    # 基于正则表达式替换
    @classmethod
    def replaces(cls, data: str):
        #这里${}是要从参数池里面读取的并且替换的数据
        replace_json_list = re.findall('\${(.*?)}', data)
        replace_f_list = re.findall('\f{(.*?)}', data)
        if len(replace_json_list)>0:
            #把要替换的值变成jsonpath表达式，从参数池里面读取,然后替换
            for i in replace_json_list:
                #i就是${}里面的值，'$.'+i把它拼接成jsonpath表达式
                print(i)
                #jsonpath(cls.access_value,'$.'+i)[0]就是从参数池里面取出的值
                print(jsonpath(cls.access_value,'$.'+i)[0])
                #f'${"{"+i+"}"}'就是要被替换的值 例${cc}，这里有语法冲突，我使用字符拼接了
                data=data.replace(f'${"{"+i+"}"}',jsonpath(cls.access_value,'$.'+i)[0])
        return eval(data)



#方法测试
if __name__ == '__main__':
    print(f'提取前参数池{ParameterSetting.access_value}')
    api_response={'code':200,'content':{'bill':'ys123456','aa':'aa的值'},'bb':'bb的值','cc':'cc的值'}
    extract_key={'bill': '$.content.bill','bb':'$.bb','cc':'$.cc','aa':'$.content.aa'}
    ParameterSetting.extract(api_response,extract_key)
    print(f'提取后参数池{ParameterSetting.access_value}')
    data={
        's':'${aa}',
        'v':['${bb}','${cc}']
    }
    print(ParameterSetting.replaces(str(data)))
    print(type(ParameterSetting.replaces(str(data))))

测试
在这里插入图片描述

六点五、出现一个坑

修改用例模板，这个格式会报错
在这里插入图片描述
解决方案直接加引号，直接在这里就把他字符化，不用外面再去字符化了，headers和assert_expression里面的json也这样处理，注意了，里面的引号就得是双引号了

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
那之前设置的字符化配置就失去意义了，先不动，有影响在改

七、新的用例模板

#用例(名称)标题，需要参数依赖的全部设置字符格式，后期解析成字典列表等格式
用例标题0:
  #接口地址，也支持参数依赖
  path: /test/{id}
  #请求方法
  method: post
  #有值就用这个，没用就使用默认配置的，有header里面使用参数依赖的场景
  headers: '{"token":"${token}"}'
  # 是否运行
  is_run: True
  # 前置sql：sql有2大类，一个是查询有返回值，一个是增删改无返回值，前置sql为无返回值类型
  #  precondition_sql:
  #    - UPDATE case_test SET title = '标题2', ex = '44' WHERE id = 2
  #    - UPDATE case_test SET title = '标题3', ex = '55' WHERE id = 3
  #请求参数较多，这里就使用原始字典格式，除了提取表达式，其他的都带上引号，预防出错,random_time()随机函数使用
  data:
    '
    {
          "id":${id},
          "projectNo": "320SF000206004",
          "name": ${name},
          "time": random_time(),
          "str": random_str(6),
          "int": random_number(5),
          # 请求参数sql为有返回值查询
          "sql": sql-SELECT title FROM case_test where id=2
        }
    '
  #参数类型 json 或者 form表单
  data_type: json
  #从接口返回结果提取哪些字段和提取表达式,比如从返回数据提取用户id和name
  extract_key:
    id: $.id
    name: $.name
  #断言表达式
  # 除了数字类型比较，其他的字符或者表达式全部带上引号,表达式必须要写在后面（必须按照格式来）
  # 断言sql为有返回值查询
  assert_expression:
    #判断响应码是否和预期一致
    code: 200
    #判断预期值是否在返回值里面（用值是否在接口返回的内容里面判断）
    body: 内容包含
    #判断json提取值是否和预期一致（用键和值比较等于，大于小于或者in判断）
    json:
      '{"ig": ${name},"rng": ${name},"edg": "${name}"}'
    #判断sql查询值是否和预期一致（用键和值作判断，规则和上面一致）
#    sql:
#      {'1':">sql-SELECT title FROM case_test where id=2",'2':"==sql-SELECT title FROM case_test where id=2"}

八、断言处理

和第二版相比除了类名其他全部不同
通过接口返回先获取到响应码，响应json信息，响应文本信息
断言code判断是否相等就行，断言body判断内容是否在返回文本里面就行
在这里插入图片描述
这里要修改下之前的requests方法，之前这个都是固定返回json，现在返回整个对象信息，使用时要自行携带token
在这里插入图片描述
json断言处理
这里也需要用到之前的正则提取，之前参数替换是用正则在参数池里面找数据，在断言这里就是在接口的返回参数里面找数据
我把方法优化了一下，把通用的地方提取了出来
在这里插入图片描述
之前的方法改成了这样
在这里插入图片描述
json断言写完，等待测试
在这里插入图片描述

相关文章：

  • Github每日精选（第38期）：Java 8+ Jar 和 Android APK 逆向工程套件（反编译器、编辑器、调试器等）bytecode-viewer
  • Pandas 操作数据（三）
  • 查题系统API无限搜题接口搭建
  • python之爬虫基础（1）
  • CVE-2022-22978 Spring-security 认证绕过漏洞分析和漏洞挖掘思考
  • 小孩取名：瑭字的寓意和含义
  • 7、IOC 之Bean定义继承 parent
  • J9数字论：模块化公链能否成为公链新趋势？
  • UVM环境中reset复位的处理
  • 示波器探头的选择和作用及原理
  • 新学期，我的FLAG不能倒~
  • 好心情精神心理科医生：精神病人为何会出现幻觉？
  • java计算机毕业设计ssm电子元件仓库管理系统
  • 数据结构与算法--数组
  • jvm oom内存溢出，导出dump，使用mat进行问题分析
  • [case10]使用RSQL实现端到端的动态查询
  • Codepen 每日精选（2018-3-25）
  • ES10 特性的完整指南
  • PermissionScope Swift4 兼容问题
  • win10下安装mysql5.7
  • 工作踩坑系列——https访问遇到“已阻止载入混合活动内容”
  • 简析gRPC client 连接管理
  • 近期前端发展计划
  • 类orAPI - 收藏集 - 掘金
  • 什么软件可以提取视频中的音频制作成手机铃声
  • 树莓派 - 使用须知
  • 译米田引理
  • 远离DoS攻击 Windows Server 2016发布DNS政策
  • 完善智慧办公建设，小熊U租获京东数千万元A+轮融资 ...
  • 我们雇佣了一只大猴子...
  • ​Linux Ubuntu环境下使用docker构建spark运行环境（超级详细）
  • ​油烟净化器电源安全，保障健康餐饮生活
  • # Swust 12th acm 邀请赛# [ E ] 01 String [题解]
  • # 学号 2017-2018-20172309 《程序设计与数据结构》实验三报告
  • #、%和$符号在OGNL表达式中经常出现
  • #中的引用型是什么意识_Java中四种引用有什么区别以及应用场景
  • (紀錄)[ASP.NET MVC][jQuery]-2 純手工打造屬於自己的 jQuery GridView (含完整程式碼下載)...
  • （十一）c52学习之旅-动态数码管
  • （万字长文）Spring的核心知识尽揽其中
  • .NET MVC之AOP
  • .NET 设计一套高性能的弱事件机制
  • .NET 指南：抽象化实现的基类
  • .NET/C# 如何获取当前进程的 CPU 和内存占用？如何获取全局 CPU 和内存占用？
  • .NET/C# 使用反射注册事件
  • .NET下ASPX编程的几个小问题
  • @Autowired和@Resource装配
  • @Transactional 竟也能解决分布式事务？
  • @zabbix数据库历史与趋势数据占用优化（mysql存储查询）
  • [2015][note]基于薄向列液晶层的可调谐THz fishnet超材料快速开关——
  • [ai笔记3] ai春晚观后感-谈谈ai与艺术
  • [BUG] Authentication Error
  • [BUUCTF]-PWN:wustctf2020_number_game解析（补码，整数漏洞）
  • [BZOJ1060][ZJOI2007]时态同步 树形dp
  • [C++从入门到精通] 14.虚函数、纯虚函数和虚析构(virtual)
  • [cb]UIGrid+UIStretch的自适应