pytest学习总结（2.13）- 跳过和失败测试用例的艺术

引言

pytest是一个强大的Python测试框架，提供了一系列实用功能来简化测试过程。其中两个关键特性是skip和xfail装饰器，它们允许开发者处理那些不能通过或不适用于特定平台或环境的测试用例。在本文中，我们将深入探讨skip和xfail的用法，并通过实际示例展示其对保持测试套件绿色和有效性的重要性。

skip装饰器：优雅地忽略测试

skip装饰器用于标记那些暂时不能运行或不适用的测试用例。它允许开发者暂时从测试套件中排除这些测试，而无需删除或注释它们。使用skip装饰器时，pytest会在运行时跳过标记的测试，并将其显示为"skipped"。

import pytest

@pytest.mark.skip("这个测试用例需要特殊的硬件，目前不可用。")
def test_special_hardware():
    pass

上面的示例演示了如何使用skip装饰器来跳过test_special_hardware测试用例，因为它需要特殊的硬件才能运行。当pytest运行时，此测试用例将被跳过，并显示为"skipped"。

xfail装饰器：期望的失败

xfail装饰器用于标记那些预期失败的测试用例。与skip不同，xfail会运行标记的测试，并将其预期失败视为成功。这意味着即使测试失败，pytest也会将其标记为"passed"，前提是失败原因与预期的失败相匹配。

import pytest

@pytest.mark.xfail(raises=TypeError, reason="此测试预期会引发TypeError异常。")
def test_type_error():
    raise TypeError

上面的示例展示了如何使用xfail装饰器来标记test_type_error测试用例，因为它预期会引发TypeError异常。当pytest运行时，此测试用例将被运行，如果它引发TypeError异常，它将被标记为"passed"，否则将标记为"failed"。

将skip和xfail与markers结合使用

skip和xfail装饰器可以与markers一起使用，以提供更细粒度的测试用例控制。markers允许开发者定义自定义元数据，以对测试用例进行分类或添加其他信息。

例如，我们可以定义一个名为requires_internet的marker来标记需要互联网连接才能运行的测试用例：

import pytest

@pytest.mark.requires_internet
def test_internet_connection():
    pass

然后，我们可以使用pytest-skip和pytest-xfail插件来跳过或失败带有特定marker的测试用例：

pytest -m "not requires_internet"

上面的命令将运行所有不带有requires_internet标记的测试用例，有效地跳过需要互联网连接的测试。

结论

skip和xfail装饰器是pytest中的重要工具，它们允许开发者处理不能通过或不适用于特定平台或环境的测试用例。通过使用这些装饰器，我们可以保持测试套件的绿色，并确保只运行那些有用的测试用例。通过将它们与markers结合使用，我们可以进一步自定义测试用例控制，并根据需要创建更复杂的测试场景。掌握这些特性将使开发者能够编写更健壮、更有效的测试，从而提高Python应用程序的质量。