Pytest中实现自动生成测试用例脚本代码

🍅 视频学习:文末有免费的配套视频可观看

🍅 点击文末小卡片,免费获取软件测试全套资料,资料在手,涨薪更快

在Python的测试框架中,我们通常会针对某个系统进行测试用例的维护,在对庞大系统进行用例维护时,往往会发现很多测试用例是差不多的,甚至大多数代码是一样的。

故为了提高我们测试用例维护的效率,在本文中,我们将探讨如何自己设计脚本,自动生成测试用例脚本。

自动发现测试原理

pytest的一个重要特性就是它可以自动发现并运行测试。所以我们只需要按照一定的命名规则来命名测试文件和测试函数,然后pytest就可以自动找到并运行这些测试。

默认情况下,pytest会运行所有名称以test_开头或者以_test结尾的.py文件中的测试。在这些文件中,pytest会运行所有名称以test_开头的函数或者方法。

例如,以下代码定义了一个测试函数:

def test_addition():
    assert 1 + 1 == 2

你可以把这个函数保存在一个名为test_example.py的文件中,然后在命令行中运行pytest命令,pytest就会自动找到并运行这个测试。

接口测试数据维护

为了达到目的,所以我们约定以特定规则进行接口测试数据的维护,我们选择json类型文件进行维护,文件目录结构如下:

需要注意的是,考虑到维护的便利性,我们推荐根据模块进行分层管理接口数据文件。

读取接口测试文件信息方法

有了接口数据文件,那么我们就可以设计一个方法,根据传入的接口模块、接口名称,进行相应的接口文件地址拼接,从而去读取json文件内容,代码如下:

class GetTestData:
    """
    获取测试数据封装模块
    """
 
    def __init__(self, logger):
        self.test_data_path = FilePathSetting.test_data_path  # 获取测试数据配置路径
        self.logger = logger
 
    def get_api_data(self, api_module, api_name):
        """
        根据接口模块和接口名称 获取接口配置信息
        :param api_module:接口模块
        :param api_name:接口名称
        :return:
        """
        # 拼接需要读取接口模板信息的*.json文件路径地址
        api_data_path = os.path.join(os.path.join(self.test_data_path, api_module), api_name)
        self.logger.info("{init_api_data} 接口模板文件地址:%s" % api_data_path)
 
        # 读取接口模板路径下的*.json信息
        with open(file=api_data_path, mode='r', encoding='utf-8') as f:
            api_data = json.load(f)
 
        self.logger.info("{init_api_data} 接口模板信息:%s" % json.dumps(api_data, ensure_ascii=False))
 
        return api_data
 
    def get_case_data(self, pytest_current_test):
        """
        根据传入的test_*.py路径 获取case配置信息
        :param pytest_current_test:
        :return:
        """
        # self.logger.info('~~~~~~~~~~~~ {init_api_data} 初始化当前接口请求模板数据 ~~~~~~~~~~~~')
        self.logger.info('{init_api_data} 当前test_case位置信息:%s' % pytest_current_test)
        # 根据传入的test_*.py路径 获取接口所属模块文件名称
        file_path = pytest_current_test.split("::Test")[0]
        self.logger.info('{init_api_data} 当前接口test_case文件地址:%s' % file_path)
 
        # 根据传入的test_*.py路径 获取接口所属模块文件名称
        api_module = os.path.split(os.path.split(file_path)[0])[1]
        self.logger.info("{init_api_data} 接口所属模块:%s" % api_module)
        # 根据传入的test_*.py路径 获取接口模板(*.json)名称
        # # api_name = os.path.split(file_path)[1].replace('.py', '.json').replace('test_', '')
        api_name = os.path.split(file_path)[1][5:].replace('.py', '.json')  # 1、截取第6个字符到结尾;2、将.py后缀替换为.json
        self.logger.info("{init_api_data} 接口模板文件名称:%s" % api_name)
 
        return self.get_api_data(api_module, api_name)

基础的测试用例模板

因为我们基础的测试用例是通用的,如以下代码实例:

import allure
import pytest
 
from utils.assertion.assert_controller import AssertController
from utils.requests_tools.requests_client import RequestClient
 
api_module = '接口模块***'
api_name = '接口名称***'
 
 
@allure.epic(api_module)
@allure.feature(api_module + '' + api_name)
class TestCaseGroup:
 
    @allure.title("接口健康检查")
    @allure.description("接口返回信息基础验证")
    @pytest.mark.smoke
    def test_smoke(self, init_api_data):
        # 获取环境配置信息&接口测试数据
        env_data, case_data = init_api_data
 
        # 获取接口返回信息
        res = RequestClient(case_data).get_api_response()
 
        # 进行断言验证
        AssertController(case_data.assert_data).assert_equality(res.response_data)

故我们就可以设计一个用例模板的生成器:

import datetime
from typing import Text
 
 
def write_case(file_path: Text, page: Text) -> None:
    """ 写入用例数据 """
    with open(file_path, 'w', encoding="utf-8") as file:
        file.write(page)
 
 
def write_init_file(*, file_path: Text) -> None:
    """
    初始化文件写入
    :param file_path: __init__文件地址
    :return:
    """
    now = datetime.datetime.now().strftime('%Y/%m/%d %H:%M')
 
    page = f'''#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Author    : gmluo1988
# @Software  : PyCharm
# @File      : __init__.py.py
# @Time      : {now}
'''
    write_case(file_path=file_path, page=page)
 
 
def write_test_case_file(*,
                         api_module: Text,
                         api_name: Text,
                         filename: Text,
                         case_path: Text) -> None:
    """
    标准测试用例文件写入
    :param api_module: 接口所属模块
    :param api_name: 接口名称名称
    :param filename: 用例文件名称
    :param case_path: 用例文件地址
    """
    now = datetime.datetime.now().strftime('%Y/%m/%d %H:%M')
 
    page = f'''#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Author    : gmluo1988
# @Software  : PyCharm
# @File      : {filename}
# @Time      : {now}
import allure
import pytest
from utils.assertion.assert_controller import AssertController
from utils.requests_tools.requests_client import RequestClient
@allure.epic("{api_module}")
@allure.feature("{api_module} {api_name}")
class TestCaseGroup:
    @allure.title("接口健康检查")
    @allure.description("接口返回信息基础验证")
    @pytest.mark.smoke
    def test_smoke(self, init_api_data):
        # 获取环境配置信息&接口测试数据
        env_data, case_data = init_api_data
        # 获取接口返回信息
        res = RequestClient(case_data).get_api_response()
        # 进行断言验证
        AssertController(case_data.assert_data).assert_equality(res.response_data)
'''
    write_case(file_path=case_path, page=page)

有了测试用例生成器,那么我们就可以根据接口模块,接口名称,以及接口相关信息生成通用的接口用例文件了。

自动生成测试用例

接下来要做事情就是读取test_data目录下所有模块下的接口文件,遍历文件列表进行测试用例的字段生成。

要注意的是:

1、该封装方法可以根据需求设置需要排除的文件列表

2、test_case目录下已经存在的用例会跳过生成

3、该封装方法生成的是一个基本通用的用例,可在生成的用例基础上进行改造

import os
 
from common.file_path_setting import FilePathSetting
from utils.case_automatic.test_case_template import write_test_case_file, write_init_file
from utils.get_test_data_tools.get_case_data import GetCaseData
 
 
class CaseAutoGenerate:
    """
    测试用例自动生成工具
    """
 
    def __init__(self):
        """设置需要排除的文件列表,一般是Cloud登录以及子系统跳转登录等前置条件接口文档"""
        self.excluded_file_list = [
            ("users", "login.json"),
            ("users", "change_password.json")
        ]
 
    def get_test_data_files(self) -> list:
        """
        获取所有测试数据文件路径信息列表
        每条测试数据由一个tuple组成,包含3个值(filename:文件名;parent_dir:父级目录名称;file_path:文件地址)
        需要排除不需要自动生成测试用例的文件
        :return:测试数据文件路径信息列表
        """
        file_info_list = []  # 所有测试数据文件路径信息列表
        # 获取测试数据目录所有文件下的子文件名称
        for root, dirs, filenames in os.walk(FilePathSetting.test_data_path):
            for filename in filenames:
                parent_dir = os.path.basename(root)  # 测试数据文件父级目录名称
                file_path = os.path.join(root, filename)  # 测试数据文件地址
 
                # 需要排除不需要自动生成测试用例的文件
                if (parent_dir, filename) not in self.excluded_file_list:
                    # 每条测试数据由一个tuple组成,包含3个值(filename:文件名;parent_dir:父级目录名称;file_path:文件地址)
                    file_info_list.append((filename, parent_dir, file_path))
 
        # 返回所有测试数据文件路径信息列表
        return file_info_list
 
    @staticmethod
    def get_test_case_files() -> tuple:
        """
        获取所有测试用例父级目录列表,测试用例文件地址列表
        需要将'__init__.py', 'conftest.py'文件进行过滤
        :return:
        """
 
        case_dir_list = []  # 用例父级目录列表
        case_path_list = []  # 测试用例文件地址列表
 
        # 获取测试用例目录下所有文件下的子文件名称
        for root, dirs, filenames in os.walk(FilePathSetting.test_case_path):
            for filename in filenames:
                parent_dir = os.path.basename(root)
                file_path = os.path.join(root, filename)
 
                # 需要将'__init__.py', 'conftest.py'文件进行过滤
                if filename not in ['__init__.py', 'conftest.py']:
                    case_path_list.append(file_path)
                    # 如果父级目录还未收录,则进行父级目录列表更新,并将'__pycache__'排除
                    if parent_dir not in case_dir_list and parent_dir not in ['__pycache__']:
                        case_dir_list.append(parent_dir)
        # 分别返回测试用例父级目录列表,测试用例文件地址列表
        return case_dir_list, case_path_list
 
    @staticmethod
    def mk_dir(test_data_file_info: tuple, existing_case_dir_list: list) -> None:
        """
        创建测试用例父级目录
        如果测试数据文件的父级目录在测试用例目录中是不存在,
        则在test_case目录下创建相同名称的package文件以及'__init__.py'文件
        :param test_data_file_info: 测试数据文件信息,包含3个值(filename:文件名;parent_dir:父级目录名称;file_path:文件地址)
        :param existing_case_dir_list: 已有的所有测试用例父级目录列表
        :return:
        """
 
        test_data_dir = test_data_file_info[1]  # 测试数据文件,父级目录名称
 
        # 如果测试数据文件的父级目录在测试用例目录中是不存在,则在test_case目录下创建相同名称的package文件以及'__init__.py'文件
        if test_data_dir not in existing_case_dir_list:
            print("test_case下缺少:{} 文件目录,进行文件新增操作...".format(test_data_dir))
            """创建相同名称的package文件"""
            dir_path = os.path.join(FilePathSetting.test_case_path, test_data_dir)
            os.makedirs(dir_path, exist_ok=True)
 
            """新增'__init__.py'文件"""
            init_file_path = os.path.join(dir_path, '__init__.py')
            # open(init_file_path, 'w').close()
            write_init_file(file_path=init_file_path)
 
    @staticmethod
    def is_case_exist(test_data_file_info: tuple, existing_case_path_list: list) -> tuple:
        """
        判断测试用例是否存在
        如果不存在,则返回需要生成测试用例的文件名和文件地址信息
        如果已经存在对应的测试用例,则返回None
        :param test_data_file_info:
        :param existing_case_path_list:
        :return:target_case_filename, target_case_file_path
        """
        test_data_filename = test_data_file_info[0]  # 测试数据文件名称
        test_data_dir_name = test_data_file_info[1]  # 测试数据文件所属父级目录名称
 
        # 拼接目标测试用例所属父级目录地址
        target_case_dir_path = os.path.join(FilePathSetting.test_case_path, test_data_dir_name)
        # 组装目标测试用例文件名称:测试用例以“test_”开头,将文件格式“.json”替换成“.py”
        target_case_filename = 'test_' + test_data_filename.replace('.json', '.py')
        # 拼接目标测试用例文件地址
        target_case_file_path = os.path.join(target_case_dir_path, target_case_filename)
 
        # if target_case_file_path in existing_case_path_list:
        #     print(target_case_file_path)
        if target_case_file_path not in existing_case_path_list:
            # 返回需要生成测试用例的文件名和文件地址信息
            return target_case_filename, target_case_file_path
        else:
            return None, None
 
    def case_automatic(self) -> None:
        """
        测试用例自动生成入口
        :return:
        """
 
        """获取所有测试数据文件路径信息列表"""
        test_data_file_info_list = self.get_test_data_files()
        """获取所有测试用例父级目录列表,测试用例文件地址列表"""
        existing_case_dir_list, existing_case_path_list = self.get_test_case_files()
 
        """遍历每个测试数据文件,如果对应的测试用例不存在,则进行测试用例自动生成操作"""
        for test_data_file_info in test_data_file_info_list:
            """创建测试用例父级目录"""
            self.mk_dir(test_data_file_info, existing_case_dir_list)
            """返回需要生成测试用例的文件名和文件地址信息"""
            target_case_filename, target_case_file_path = self.is_case_exist(test_data_file_info,
                                                                             existing_case_path_list)
            """创建对应的测试用例文件"""
            if target_case_filename and target_case_file_path:
                print("测试用例文件:{} 不存在,进行测试文件新增...".format(target_case_file_path))
                test_data_file_path = test_data_file_info[2]
                case_data = GetCaseData().get_api_data_by_path(test_data_file_path)
                api_module = case_data.api_module
                api_name = case_data.api_name
                write_test_case_file(api_module=api_module,
                                     api_name=api_name,
                                     filename=target_case_filename,
                                     case_path=target_case_file_path)
 
 
if __name__ == '__main__':
    print("Generating test case...")
    case_auto_generate = CaseAutoGenerate()
    case_auto_generate.case_automatic()

总结

Python中通过自己设计脚本,从而能够自动生成测试用例脚本,提高我们测试用例维护的效率,当然不同的系统可能有自己特别的方式,在此是为大家作个参考。

同时,在这我也准备了一份软件测试视频教程(含接口、自动化、性能等),需要的可以直接在下方观看就行,希望对你有所帮助!

字节大佬,一周讲完,自动化测试项目实战,这套教程是怎么称霸B站的?【2024最新版】

  • 4
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值