【pytest】Hook 方法之 pytest_runtest_protocol：获取将要执行的用例(item)及下一个测试用例(nextitem)

Hook 方法之 pytest_runtest_protocol：

pytest_runtest_protocol ：
官方给的解释是：为给定的测试项目执行runtest_setup / call / teardown协议；

@hookspec(firstresult=True)
def pytest_runtest_protocol(item, nextitem):
    """...  
    """

pytest_runtest_protocol 是在每个测试用例执行之前调用一次，它接收两个参数：

• item ：要执行的测试用例对象；
• nextitem ：预计的下一个测试用例对象；

获取到当前要执行的测试用例及下一个测试用例：

先准备三条测试用例：

class TestDemoA:

    def test_A_001(self):
        pass

    def test_A_002(self):
        pass

    def test_A_003(self):
        pass

# conftest.py

import pytest
from pluggy import HookspecMarker

hookspec = HookspecMarker("pytest")

# 1. 调用钩子方法，获取到用例对象并赋值给全局变量
@hookspec(firstresult=True)
def pytest_runtest_protocol(item, nextitem):
    print()
    print('执行hook方法，将 item,nextitem 赋值全局变量')
    print('当前用例的对象', item)
    print('下一个用例的对象', nextitem)
    global Item, NextItem
    Item = item
    NextItem = nextitem

# 2. 创建一个 fixture，从全局变量的用例对象中获取用例名
@pytest.fixture(autouse=True)
def print_fix():
    print()
    name = Item.name
    
    # 3. 注意，如果是最后一条用例执行前调用钩子方法，那么 NextItem 则是 None；
    if NextItem:
        next_name = NextItem.name
    else:
        next_name = None
    print('要执行用例的名称：', name)
    print('预计下一个测试用例的名称', next_name)

if __name__ == '__main__':
    pytest.main(['-s', '-q'])

执行结果：

 

pytest_runtest_protocol 相关的钩子方法：

这三个钩子方法都是在 pytest_runtest_protocol 之后调用，分别负责：调用用例的 setup，执行测试用例，调用测试用例 teardown，他们接收的参数也都是测试用例对象(item,  nextitem)：

def pytest_runtest_setup(item):
    """ 在 "pytest_runtest_call(item)" 之前调用 """

def pytest_runtest_call(item):
    """ 调用并执行测试用例(item) """

def pytest_runtest_teardown(item, nextitem):
    """ 在 "pytest_runtest_call(item)" 之后调用 """