本文转自测试人社区，原文链接： https://ceshiren.com/t/topic/31775

一、pytest 插件

1.1 插件分类
  • 外部插件：pip install 安装的插件
  • 本地插件：pytest自动模块发现机制（conftest.py存放的）
  • 内置插件：代码内部的_pytest目录加载
1.2 常用插件
pip install pytest-ordering  控制用例的执行顺序（重点）
pip install pytest-xdist    分布式并发执行测试用例（重点）
pip install pytest-dependency   控制用例的依赖关系 （了解）
pip install pytest-rerunfailures   失败重跑（了解）
pip install pytest-assume          多重较验（了解）
pip install pytest-random-order  用例随机执行（了解）
pip install pytest-html            测试报告（了解）
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.

二、pytest 执行顺序控制

  • 场景：
  • 对于集成测试，经常会有上下文依赖关系的测试用例。
  • 比如10个步骤，拆成10条case，这时能知道到底执行到哪步报错。
  • 用例默认执行顺序：自上而下执行。
  • 解决：
  • 可以通过setup，teardown和fixture来解决；
  • 也可以使用对应的插件。
  • 安装：
  • pip install pytest-ordering
  • 用法：
  • @pytest.mark.run(order=2)
  • 注意：
  • 多个插件装饰器(>2)时，可能会发生冲突。

三、pytest测试用例并行运行与分布式

3.1 pytest并行与分布式执行
  • 场景1：
  • 测试用例1000条，一条用例执行1分钟，一个测试人员执行需要1000分钟。
  • 通常我们会用人力成本换取时间成本，加几个人一起执行，时间就会缩短。
  • 如果10个人一起执行只需要100分钟，这就是一种分布式场景。
  • 场景2：
  • 假设有个报名系统，对报名总数统计，数据同时进行修改操作的时候，有可能会出现问题，需要模拟这个场景，就需要多用户并发请求数据。
  • 解决：
  • 使用分布式并发执行测试用例；
  • 分布式插件：pytest-xdist；
  • 安装运行：pip install pytest-xdist
  • 注意：
  • 用例多的时候效果明显，多进程并发执行，同时支持allure。
3.2 分布式执行测试用例的原则
  • 用例之间是独立的，不要有依赖关系；
  • 用例执行没有顺序，随机顺序都能正常运行；
  • 每个用例都能重复运行，运行结果不会影响其他用例。

四、pytest内置插件hook体系

4.1 pytest hook 介绍

软件测试学习笔记丨Pytest插件_用例

  • hook是个函数，在系统消息触发时被系统调用；
  • 自动触发机制；
  • hook函数的名称是确定的；
  • pytest有非常多的hook函数；
  • 使用时直接编写函数体。
4.2 pytest hook执行顺序
site-package/_pytest/hookspec.py

pytest_addoption :  添加命令行参数，运时会先读取命令行参数
pytest_collection_modifyitems : 收集测试用例，收集之后（改编码，改执行顺序）
pytest_collection_finish：收集之后的操作
pytest_runtest_setup：在调用 pytest_runtest_call 之前调用
pytest_runtest_call：调用执行测试的用例
pytest_runtest_makereport：运行测试用例，返回setup，call，teardown的执行结果
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
4.3 简单示例
def pytest_runtest_setup(item):    
  # 执行测试用例前执行的setup方法    
  print("setting up", item)

def pytest_runtest_call(item):    
  # 调用执行测试的用例
  print("pytest_runtest_call")

def pytest_runtest_teardown(item):   
  #  执行测试用例后执行的teardown
  print("pytest runtest teardown",item)
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
4.4 总结
  1. hook函数名字固定；
  2. hook函数会被自动执行；
  3. 执行是有先后顺序的；
  4. pytest定义了很多hook函数，可以在不同阶段实现不同的功能。

五、pytest编写自己的插件

5.1 修改默认编码
  • pytest_collection_modifyiterms收集上来的测试用例，实现定制化功能。
  • 解决问题：
  • 自定义用例的执行顺序；
  • 解决编码问题（中文的测试用例名称）；
  • 自动添加标签。
  • 含有中文的测试用例名称，改写编码格式：
def pytest_collection_modifyitems(session, config, items):
  for item in items:
    item.name = item.name.encode('utf-8').decode('unicode-escape')
    item._nodeid = item.nodeid.encode('utf-8').decode('unicode-escape')
  • 1.
  • 2.
  • 3.
  • 4.
5.2 添加命令行参数
def pytest_addoption(parser):
    mygroup = parser.getgroup("hogwarts")     #group 将下面所有的 option都展示在这个group下。
    mygroup.addoption("--env",    #注册一个命令行选项
        default='test',      # 参数的默认值
        dest='env',            #  存储的变量，为属性命令，可以使用Option对象访问到这个值，暂用不到
        help='set your run env'    # 帮助提示 参数的描述信息
        )

@pytest.fixture(scope='session')
def cmdoption(request):
    return request.config.getoption("--env")
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
5.3 打包发布
  • 打包发布到pypi：
  • 代码上传到：github
  • 打包项目构成：
5.4 setup.py配置
构建文件 setup.py 代码路径：
https://ceshiren.com/t/topic/14156

from setuptools import setup,find_packages
setup(
    name='pytest_encode',
    url='https://github.com/xxx/pytest-encode',
    version='1.0',
    author="xixi",
    author_email='418974188@qq.com',
    description='set your encoding and logger',
    long_description='Show Chinese for your mark.parametrize(). Define logger variable for getting your log',
    classifiers=[# 分类索引 ，pip 对所属包的分类
        'Framework :: Pytest',
        'Programming Language :: Python',
        'Topic :: Software Development :: Testing',
        'Programming Language :: Python :: 3.8',
    ],
    license='proprietary',
    packages = find_packages(), #['pytest_encode'],
    keywords=[
        'pytest', 'py.test', 'pytest_encode',
    ],

    # 需要安装的依赖
    install_requires=[
        'pytest'
    ],
    # 入口模块 或者入口函数
    entry_points={
        'pytest11': [
            'pytest_encode = pytest_encode.main',
        ]
    },
    zip_safe=False
)
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
5.5 打包命令
依赖包安装：
pip install setuptools  python 的包管理工具，负责 安装和发布，尤其是安装拥有信赖关系的包。
pip install wheel       生成 *.whl 格式的安装包，本质上也是一个压缩包

打包命令：
python setup.py sdist bdist_wheel
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
5.6 发布命令
python3 -m pip install --user --upgrade twine       ## 安装 twine 工具
python3 -m twine upload --repository testpypi dist/*     ## 上传代码
  • 1.
  • 2.