超详细从入门到精通，pytest自动化测试框架实战-pytest插件的开发（八）

---

前言

pytest框架采用的是插件系统的模式来设计的，pytest运行的所有流程都是基于插件实现的钩子来实现的。

一个插件包含一个或多个钩子函数。编写钩子 解释了如何自己编写钩子函数的基础知识和细节。

Pytest自动化测试框架：https://www.bilibili.com/video/BV18K411m7FH/

pytest通过调用插件的指定钩子来实现配置、收集、运行和报告的各个方面：

内置插件：从 pytest 的内部_pytest目录加载。
外部插件：通过 setuptools 入口点发现的模块。
conftest.py 插件：在测试目录中自动发现的模块。

原则上，每个钩子调用都是一个1:NPython 函数调用，其中N是给定钩子的已注册实现函数的数量。所有钩子都遵循pytest_前缀命名约定，使其易于区分和查找。

pytest启动时插件发现顺序

pytest通过以下方式在工具启动时加载插件模块：

1.通过扫描命令行中的选项并阻止加载该插件（即使是内置插件也可以通过这种方式阻止）。这发生在正常的命令行解析之前。-p no:name
2.通过加载所有内置插件。
3.通过扫描命令行选项并加载指定的插件。这发生在正常的命令行解析之前。-p name
4.通过加载通过setuptools 入口点注册的所有插件。
5.通过加载通过PYTEST_PLUGINS环境变量。
6.通过加载conftest.py命令行调用推断的所有文件：
如果没有指定测试路径，则使用当前目录作为测试路径；
如果存在，则加载conftest.py并test*/conftest.py相对于第一个测试路径的目录部分。加载文件后conftest.py ，加载其 pytest_plugins变量中指定的所有插件（如果存在）
；
注意：pytest 在工具启动时不会conftest.py在更深的嵌套子目录中找到文件。
conftest.py将文件保存在顶级测试或项目根目录中通常是个好主意。
7.通过递归加载 文件中pytest_plugins变量指定的所有插件conftest.py。

插件开发流程

明确需求：开发一个什么功能的插件？
分析需求：这个功能在pytest执行的那个阶段执行？
找出实现需要用到的钩子函数
在conftest.py中定义对应的钩子函数实现相关的功能

插件开发：并发执行用例的插件开发

需求
需求一：开发一个并发执行测试的插件
通过pytest执行测试时，可以使用参数指定并发执行的线程数量和并发执行的最小任务

需求二：插件需要实现以下几个命令行参数
–runTask : 指定并发执行的最小任务可传以下几个参数值
mod: 测试文件为并发最小执行任务(可以保证测试文件中的用例执行先后顺序)
case: 测试用例为并发最小执行任务
–current: 最大的并发执行数

需求分析

需求一：在测试执行的阶段
pytest添加运行参数的钩子函数：https://www.osgeo.cn/pytest/writing_plugins.html#writing-hook-functions

def pytest_runtestloop(session):

 for item in session.items:
     item.ihook.pytest_runtest_protocol(item=item, nextitem=None)
 return True

需求二：实现自己写自定义参数，在初始化阶段，需要使用的钩子函数为：pytest_addoption

pytest添加运行参数的钩子函数：https://www.osgeo.cn/pytest/writing_plugins.html#writing-hook-functions

def pytest_addoption(parser):
 # 添加参数分组
 group = parser.getgroup('pytest-thread')
 # 添加参数信息
 group.addoption('--current', default=None, help='运行的线程数量')

pytest中的更多的钩子函数文档：https://www.osgeo.cn/pytest/reference.html#hooks

参数的获取：在pytest钩子函数中，可以通过session.config.getoption(‘–current’)去获取参数

代码实现

def pytest_addoption(parser):
    """添加参数名称"""
    # 添加参数分组
    group = parser.getgroup('pytest-current')
    # 添加参数和帮助信息
    group.addoption('--unit', default=None, help='并发执行的任务单位',type="string")
    group.addoption('--current', default=None, help='运行的并发数量',type="int")

def pytest_runtestloop(session):
    # 获取并发数量      
    Count = session.config.getoption('--current')
    # 并发执行的任务单位
    unit = session.config.getoption('--unit')
    # 将测试用例按模块进行拆分
    dictCase = {}
    for item in session.items:
        # 获取用例所属模块
        mod = item.module
        # 判断dictCase是否有该测试模块
        if dictCase.get(mod):
            dictCase[mod].append(item)
        else:
            dictCase[mod] = []
            dictCase[mod].append(item)
          
    # 开启协程并发执行
    gs = []
    for cases in dictCase.values():
        g = gevent.spawn(run_test_mod, cases)
        gs.append(g)
    gevent.joinall(gs)
    return True


def run_test_mod(cases):
    """
    :param cases: 用例列表
    :return:
    """
    for item in cases:
        item.ihook.pytest_runtest_protocol(item=item, nextitem=None)

插件打包上传

参照官方文档：https://packaging.python.org/en/latest/tutorials/packaging-projects/#packaging-your-project

创建一个pytest插件项目
源码目录：(编写插件源码)

readme.md (说明文档)
setup.py（打包配置文件）
LICENSE：开源许可协议

编写插件功能代码
在src目录下创建py文件，编写插件核心代码

def pytest_addoption(parser):
    """添加参数名称"""
    # 添加参数分组
    group = parser.getgroup('pytest-current')
    # 添加参数和帮助信息
    group.addoption('--unit', default=None, help='并发执行的任务单位',type="string")
    group.addoption('--current', default=None, help='运行的并发数量',type="int")

def pytest_runtestloop(session):
    # 获取并发数量      
    Count = session.config.getoption('--current')
    # 并发执行的任务单位
    unit = session.config.getoption('--unit')
    # 将测试用例按模块进行拆分
    dictCase = {}
    for item in session.items:
        # 获取用例所属模块
        mod = item.module
        # 判断dictCase是否有该测试模块
        if dictCase.get(mod):
            dictCase[mod].append(item)
        else:
            dictCase[mod] = []
            dictCase[mod].append(item)

    # 开启协程并发执行
    gs = []
    for cases in dictCase.values():
        g = gevent.spawn(run_test_mod, cases)
        gs.append(g)
    gevent.joinall(gs)
    return True


def run_test_mod(cases):
    """
    :param cases: 用例列表
    :return:
    """
    for item in cases:
        item.ihook.pytest_runtest_protocol(item=item, nextitem=None)

配置打包信息

在项目目录下创建setup.py文件

from setuptools import setup

setup(
    name="pytest-mm",
    version='0.0.1',
    packages=["pytest_mm"],
    # 指定插件文件
    entry_points={"pytest11": ["pytest-lemon = pytest_mm.mm"]},
    # pypi插件分类器
    classifiers=["Framework :: Pytest"],
)

注意： pytest 查找插件是根据pytest11入口来查找的安装的第三方包的
Writing plugins — pytest documentation

对项目进行打包

python setup.py sdist bdist_wheel

发布插件到PYPI

在PYPI上注册账号
地址：https://pypi.org/account/register/

安装twine

pip install twine

使用twine发布插件到pypi

twine upload dist/*

twine upload --repository testpypi dist/*

并发执行的插件pytest_parallel

下面是我整理的2023年最全的软件测试工程师学习知识架构体系图

一、Python编程入门到精通

二、接口自动化项目实战

三、Web自动化项目实战

四、App自动化项目实战

五、一线大厂简历

六、测试开发DevOps体系

七、常用自动化测试工具

八、JMeter性能测试

九、总结（尾部小惊喜）

只要心中有梦想，就不要轻言放弃。相信自己，你拥有战胜一切困难的力量。坚持不懈地追求，成功就在不远处等待着你。

只要有梦想，就有奋斗的必要；只要有热爱，就有追求的动力。人生不止眼前的苟且，还有诗和远方。让我们以坚定的信念和不懈的努力，去实现自己的理想和目标，创造属于自己的辉煌人生！

人生不是一场马拉松，而是无数个短跑的积累。只有经历过奋斗，才能变得更加坚强。不要放弃自己的梦想，即使路途艰辛，也要勇往直前，因为你所拥有的，远比你所失去的更珍贵。