pytest获取测试用例执行结果（钩子函数：pytest_runtest_makereport）

前言

pytest测试框架提供的很多钩子(Hooks)方法方便我们对测试用例框架进行二次开发，可以根据自己的需求进行改造。

例如：钩子方法：pytest_runtest_makereport ，可以更清晰的了解用例的执行过程，并获取到每个用例的执行结果。

pytest_runtest_makereport方法源码

先看下相关的源码，在 _pytest/runner.py 文件下，可以导入之后，点进去查看：

from _pytest import runner

# 对应源码
def pytest_runtest_makereport(item, call):
    """ return a :py:class:`_pytest.runner.TestReport` object
    for the given :py:class:`pytest.Item` and
    :py:class:`_pytest.runner.CallInfo`.
    """

 item 是测试用例， call 是测试步骤，具体执行过程如下：

①先执行  when=’setup’  返回setup的执行结果。

②然后执行  when=’call’  返回call的执行结果。

③最后执行  when=’teardown’  返回teardown的执行结果。

第一个案例

conftest.py 文件编写 pytest_runtest_makereport 钩子方法，打印运行过程和运行结果。

# conftest.py 

import pytest

@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    print('用例执行结果', out)

    # 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    print('测试报告：%s' % report)
    print('步骤：%s' % report.when)
    print('nodeid：%s' % report.nodeid)
    print('description:%s' % str(item.function.__doc__))
    print(('运行结果: %s' % report.outcome))

test_a.py 写一个简单的用例：

def test_a():

    '''用例描述:test_a'''

    print("123")

运行结果：

结果分析：

从结果可以看到，用例的过程会经历3个阶段：

setup -> call -> teardown

每个阶段会返回 Result 对象和 TestReport 对象，以及对象属性。（setup和teardown上面的用例默认没有，结果都是passed。）

第二个案例

给用例写个 fixture函数 增加用例的前置和后置操作； conftest.py 如下：

import pytest

@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    print('用例执行结果', out)

    # 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    print('测试报告：%s' % report)
    print('步骤：%s' % report.when)
    print('nodeid：%s' % report.nodeid)
    print('description:%s' % str(item.function.__doc__))
    print(('运行结果: %s' % report.outcome))


@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    yield 
    print("teardown 后置操作")
    

运行结果：

第三个案例

 fixture函数 的 setup 前置函数在执行时异常，即 setup 执行结果为 failed ，则后面的 call 测试用例与 teardown 后置操作函数都不会执行。

此时的状态是 error ，也就是代表测试用例还没开始执行就已经异常了。（在执行前置操作函数的时候就已经异常了）

import pytest


@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    print('用例执行结果', out)

    # 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    print('测试报告：%s' % report)
    print('步骤：%s' % report.when)
    print('nodeid：%s' % report.nodeid)
    print('description:%s' % str(item.function.__doc__))
    print(('运行结果: %s' % report.outcome))


@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    assert 1 == 2
    yield
    print("teardown 后置操作")

运行结果：

第四个案例

 setup 前置操作函数正常执行，测试用例 call 执行出现异常。

此时的测试用例执行结果为 failed 

#  conftest.py

import pytest


@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    print('用例执行结果', out)

    # 3. 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    print('测试报告：%s' % report)
    print('步骤：%s' % report.when)
    print('nodeid：%s' % report.nodeid)
    print('description:%s' % str(item.function.__doc__))
    print(('运行结果: %s' % report.outcome))


@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    yield
    print("teardown 后置操作")

#  test_a.py

def test_a():
    """用例描述:test_a"""

    print("123")
    assert 1 == 0

运行结果：

第五个案例

 setup 前置操作函数正常执行，测试用例 call 正常执行， teardown 后置操作函数执行时发生异常。

测试用例正常执行，但是测试结果中会有 error ，因为 teardown 后置操作函数在执行时发生异常

# conftest.py

import pytest


@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    print('用例执行结果', out)

    # 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    print('测试报告：%s' % report)
    print('步骤：%s' % report.when)
    print('nodeid：%s' % report.nodeid)
    print('description:%s' % str(item.function.__doc__))
    print(('运行结果: %s' % report.outcome))


@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    yield
    print("teardown 后置操作")
    raise Exception("teardown 失败了")

#  test_a.py

def test_a():
    '''用例描述:test_a'''
    print("123")

运行结果：

第六个案例：只获取call结果

场景：编写测试用例时，在保证 setup 前置操作函数和 teardown 后置操作函数不报错的前提下，只需要关注测试用例的执行结果，即只需要获取测试用例执行call的结果。

解决办法：因为前面的 pytest_runtest_makereport 钩子方法执行了三次。所以在打印测试报告的相关数据之气可以加个判断： if report.when == “call”  。

import pytest
from _pytest import runner

'''
# 对应源码
def pytest_runtest_makereport(item, call):
    """ return a :py:class:`_pytest.runner.TestReport` object
    for the given :py:class:`pytest.Item` and
    :py:class:`_pytest.runner.CallInfo`.
    """
'''


@pytest.hookimpl(hookwrapper=True, tryfirst=True)
def pytest_runtest_makereport(item, call):
    print('------------------------------------')

    # 获取钩子方法的调用结果
    out = yield
    # print('用例执行结果:', out)

    # 从钩子方法的调用结果中获取测试报告
    report = out.get_result()

    if report.when == "call":
        print('测试报告：%s' % report)
        print('步骤：%s' % report.when)
        print('nodeid：%s' % report.nodeid)
        print('description:%s' % str(item.function.__doc__))
        print(('运行结果: %s' % report.outcome))


@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    yield
    print("teardown 后置操作")

运行结果：

 conftest.py 去除pytest_runtest_makereport 钩子方法，正常执行测试用例

# conftest.py

import pytest

@pytest.fixture(scope="session", autouse=True)
def fix_a():
    print("setup 前置操作")
    yield
    print("teardown 后置操作")

# test_a.py

def test_a():
    """用例描述:test_a"""

    print("123")

运行结果：