序章

第一代框架

源码地址

教程

第二代框架

源码地址

搭建教程

使用教程

一、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"}

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

‘headers’,‘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))))

测试

问题：yaml格式错误

修改用例模板，这个格式会报错

解决方案直接加引号，直接在这里就把他字符化，不用外面再去字符化了，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"}