软件测试 | Pytest 测试用例调度与运行

更多软件测试学习资料戳

Pytest 是一个功能强大的测试框架，不仅提供了丰富的功能来编写测试，还提供了灵活的测试用例调度与运行方式。本文将介绍如何在 Pytest 中调度和运行测试用例，包括使用命令行选项、测试用例标记、运行特定文件或目录以及一些高级用法。

基本命令行用法

运行所有测试

在项目的根目录下运行以下命令，可以执行所有的测试用例：

pytest

运行特定文件

如果只想运行某个特定文件中的测试，可以指定文件路径：

pytest test_example.py

运行特定目录

要运行某个目录中的所有测试文件，可以指定目录路径：

pytest tests/

运行特定的测试类或函数

可以通过以下方式运行特定的测试类或测试函数：

pytest test_example.py::TestClasspytest test_example.py::TestClass::test_methodpytest test_example.py::test_function

使用标记调度测试

Pytest 提供了标记（Mark）功能，允许我们对测试用例进行标记，然后根据标记来调度运行测试。常用的标记有 @pytest.mark.parametrize、@pytest.mark.skip、@pytest.mark.xfail 等。

自定义标记

可以创建自定义标记，使用 -m 选项来运行具有特定标记的测试用例。

首先，需要在项目根目录下创建或编辑 pytest.ini 文件来注册自定义标记：

[pytest]markers =    slow: mark test as slow    fast: mark test as fast

然后，可以在测试函数中使用这些标记：

import pytest
@pytest.mark.slowdef test_slow_function():    import time    time.sleep(5)    assert True
@pytest.mark.fastdef test_fast_function():    assert True

运行具有特定标记的测试用例：

pytest -m slowpytest -m fast

组合标记

可以通过逻辑运算符组合多个标记来运行测试。例如，运行所有标记为 slow 或 fast 的测试：

pytest -m "slow or fast"

选择和排除测试

Pytest 提供了一些选项来选择或排除特定的测试用例。

选择特定测试用例

可以使用 -k 选项根据测试名称选择测试用例：

pytest -k "test_example"

这将运行名称中包含 test_example 的所有测试用例。

排除特定测试用例

可以结合 not 关键字排除某些测试用例：

pytest -k "not test_example"

这将排除名称中包含 test_example 的所有测试用例。

控制测试用例顺序

默认情况下，Pytest 按照文件系统顺序发现并运行测试用例。可以通过插件或钩子函数来自定义运行顺序。

使用 pytest-ordering 插件

pytest-ordering 插件允许我们指定测试用例的运行顺序。可以通过 pip 安装：

pip install pytest-ordering

使用示例：

import pytest
@pytest.mark.run(order=2)def test_second():    assert True
@pytest.mark.run(order=1)def test_first():    assert True
@pytest.mark.run(order=3)def test_third():    assert True

这将按照指定的顺序运行测试用例。

自定义钩子函数

可以通过实现 pytest_collection_modifyitems 钩子函数来自定义测试用例的运行顺序：

# conftest.py
def pytest_collection_modifyitems(items):    items.sort(key=lambda x: x.name)

运行测试并生成报告

Pytest 可以生成丰富的测试报告。常用的选项有：

生成详细报告

使用 -v 选项可以生成详细的测试报告：

pytest -v

生成 JUnit XML 报告

可以生成 JUnit 兼容的 XML 报告，方便与 CI/CD 集成：

pytest --junitxml=report.xml

使用 pytest-html 生成 HTML 报告

pytest-html 插件允许生成 HTML 格式的测试报告。可以通过 pip 安装：

pip install pytest-html

运行测试并生成 HTML 报告：

pytest --html=report.html

结论

Pytest 提供了丰富的命令行选项和功能，帮助我们灵活地调度和运行测试用例。从基本的文件和目录选择，到高级的标记、选择和排除测试用例，再到自定义运行顺序和生成报告，Pytest 能满足各种测试需求。熟练掌握这些功能，可以显著提高测试效率和质量。