pytest.mark¶

@pytest.mark.skip/skipif 跳过测试¶

@pytest.mark.skip 是一个用于在 pytest 测试框架中跳过某些测试用例或测试类的装饰器。其主要作用是临时禁用一些不需要运行的测试

常用于以下几种情况:

1. 测试尚未完成或稳定
    当某些测试用例还在开发中或者有已知问题暂时不能解决时，可以使用这个装饰器跳过它们，以便不会影响整体测试的运行。
2. 外部依赖不可用
    如果某些测试依赖于外部资源（如数据库、网络服务）而这些资源暂时不可用，使用 @pytest.mark.skip 可以跳过这些测试，避免测试失败。
3. 条件性跳过
    根据某些条件决定是否跳过测试，例如特定的平台或环境下运行时跳过某些测试

示例:

import pytest

@pytest.mark.skip(reason="Test is under development")
def test_example():
    assert 1 == 1

# 条件性跳过测试
@pytest.mark.skipif(sys.platform == "win32", reason="does not run on windows")
def test_example_on_non_windows():
    assert 1 == 1

@pytest.mark.xfail 标记失败¶

使用@pytest.mark.xfail标记用例，表示期望这个用例执行失败。
标记后的用例会正常执行，只是失败时不再显示堆栈信息，最终的结果有两个：用例执行失败时（XFAIL：符合预期的失败）、用例执行成功时（XPASS：不符合预期的成功）

结构:

pytest.mark.xfail(condition=None, *, reason=None, raises=None, run=True, strict=False)
参数:
condition位置参数，默认值为None，表示只有满足条件时才标记用例；
reason关键字参数，默认值为None，表示可以指定一个reason字符串，说明标记用例的原因；
raises关键字参数，默认值为None
    可以指定为一个异常类或者多个异常类的元组，表示我们期望用例上报指定的异常；
    如果用例的失败不是因为所期望的异常导致的，pytest将会把测试结果标记为FAILED;
run关键字参数，默认值为True:
    当run=False时，pytest不会再执行测试用例，直接将结果标记为XFAIL；
strict关键字参数，默认值为False
    当strict=False时，如果用例执行失败，结果标记为XFAIL，表示符合预期的失败；如果用例执行成功，结果标记为XPASS，表示不符合预期的成功；
    当strict=True时，如果用例执行成功，结果将标记为FAILED；

示例:

import pytest

@pytest.mark.xfail
def test_example():
    assert 1 == 2

@pytest.mark.asyncio¶

参见: 插件-pytest-asyncio

@pytest.mark.parametrize¶

allows you to run a test function multiple times with different sets of arguments.
This is especially useful for testing functions with multiple input scenarios in a concise and readable way.

示例:

def add(a, b):
    return a + b

import pytest

@pytest.mark.parametrize("a, b, expected", [
    (1, 2, 3),
    (4, 5, 9),
    (-1, -2, -3),
    (0, 0, 0),
])
def test_add(a, b, expected):
    assert add(a, b) == expected


"""
结果:
normal/pytest/mark/test_mark_parametrize.py::test_add[1-2-3] PASSED
normal/pytest/mark/test_mark_parametrize.py::test_add[4-5-9] PASSED
normal/pytest/mark/test_mark_parametrize.py::test_add[-1--2--3] PASSED
normal/pytest/mark/test_mark_parametrize.py::test_add[0-0-0] PASSED
"""