前言
pytest测试框架提供的很多钩子函数方便我们对测试框架进行二次开发,可以根据自己的需求进行改造。
例如:钩子方法: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`.
"""
装饰器 pytest.hookimpl(hookwrapper=True, tryfirst=True)
解释:
@pytest.hookimpl(hookwrapper=True)
装饰的钩子函数,有以下两个作用:
1、可以获取到测试用例不同执行阶段的结果(setup,call,teardown)
2、可以获取钩子方法 pytest_runtest_makereport(item, call)
的调用结果(yield返回一个测试用例执行后的result对象)和调用结果result对象中的测试报告(返回一个report对象)
pytest_runtest_makereport(item, call)
钩子函数参数解释:
1、 item
是测试用例对象;
2、 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('------------------------------------')
# 获取钩子方法的调用结果,返回一个result对象
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")
运行结果:
自动化测试相关教程推荐:
2023最新自动化测试自学教程新手小白26天入门最详细教程,目前已有300多人通过学习这套教程入职大厂!!_哔哩哔哩_bilibili
2023最新合集Python自动化测试开发框架【全栈/实战/教程】合集精华,学完年薪40W+_哔哩哔哩_bilibili
测试开发相关教程推荐
2023全网最牛,字节测试开发大佬现场教学,从零开始教你成为年薪百万的测试开发工程师_哔哩哔哩_bilibili
postman/jmeter/fiddler测试工具类教程推荐
讲的最详细JMeter接口测试/接口自动化测试项目实战合集教程,学jmeter接口测试一套教程就够了!!_哔哩哔哩_bilibili
2023自学fiddler抓包,请一定要看完【如何1天学会fiddler抓包】的全网最详细视频教程!!_哔哩哔哩_bilibili
2023全网封神,B站讲的最详细的Postman接口测试实战教学,小白都能学会_哔哩哔哩_bilibili
总结:
光学理论是没用的,要学会跟着一起敲,要动手实操,才能将自己的所学运用到实际当中去,这时候可以搞点实战案例来学习。
如果对你有帮助的话,点个赞收个藏,给作者一个鼓励。也方便你下次能够快速查找。
如有不懂还要咨询下方小卡片,博主也希望和志同道合的测试人员一起学习进步
在适当的年龄,选择适当的岗位,尽量去发挥好自己的优势。
我的自动化测试开发之路,一路走来都离不每个阶段的计划,因为自己喜欢规划和总结,
测试开发视频教程、学习笔记领取传送门!!