前言
pytest提供的不少钩子(Hooks)方法方便咱们对测试用例框架进行二次开发,能够根据本身的需求进行改造。
先学习下pytest_runtest_makereport这个钩子方法,能够更清晰的了解用例的执行过程,并获取到每一个用例的执行结果。
html
pytest_runtest_makereport
先看下相关的源码,在_pytest/runner.py
下,能够导入以后,点进去查看node
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是测试步骤,具体执行过程以下:session
- 先执行when='setup' 返回setup 的执行结果
- 而后执行when='call' 返回call 的执行结果
- 最后执行when='teardown'返回teardown 的执行结果
运行案例
conftest.py 写 pytest_runtest_makereport 内容,打印运行过程和运行结果app
# 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))
test_a.py写一个简单的用例框架
def test_a(): '''用例描述:test_a''' print("上海-悠悠")
运行结果以下学习
D:\soft\code\pytest_jenkins_demo\demo>pytest -s ============================= test session starts ============================= platform win32 -- Python 3.6.0, pytest-4.5.0, py-1.5.4, pluggy-0.13.1 rootdir: D:\demo plugins: html-1.19.0, collected 1 item test_a.py ------------------------------------ 用例执行结果 <pluggy.callers._Result object at 0x0000027C547332B0> 测试报告:<TestReport 'test_a.py::test_a' when='setup' outcome='passed'> 步骤:setup nodeid:test_a.py::test_a description:用例描述:test_a 运行结果: passed 上海-悠悠 ------------------------------------ 用例执行结果 <pluggy.callers._Result object at 0x0000027C547332B0> 测试报告:<TestReport 'test_a.py::test_a' when='call' outcome='passed'> 步骤:call nodeid:test_a.py::test_a description:用例描述:test_a 运行结果: passed .------------------------------------ 用例执行结果 <pluggy.callers._Result object at 0x0000027C54750A20> 测试报告:<TestReport 'test_a.py::test_a' when='teardown' outcome='passed'> 步骤:teardown nodeid:test_a.py::test_a description:用例描述:test_a 运行结果: passed ========================== 1 passed in 0.06 seconds ===========================
从运行结果能够看出,运行用例的过程会经历三个阶段:setup-call-teardown,每一个阶段都会返回的 Result 对象和 TestReport 对象,以及对象属性。
setup和teardown上面的用例默认都没有,结果都是passed。
测试
setup和teardown
给用例写个fixture增长用例的前置和后置操做,conftest.py内容以下spa
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 后置操做")
运行结果以下3d
setup失败状况
当setup执行失败了,setup的执行结果的failed,后面的call用例和teardown都不会执行了code
此时用例的状态是:error, 也就是用例(call)都还没开始执行,就异常了。
call失败状况
若是setup正常执行,可是测试用例call失败了
@pytest.fixture(scope="session", autouse=True) def fix_a(): print("setup 前置操做") yield print("teardown 后置操做")
test_a.py用例
def test_a(): '''用例描述:test_a''' print("上海-悠悠") assert 1==0
那么此时运行的结果就是failed
teardown失败了
若是setup正常执行,测试用例call正常执行,teardown失败了,这种状况
@pytest.fixture(scope="session", autouse=True) def fix_a(): print("setup 前置操做") yield print("teardown 后置操做") raise Exception("teardown 失败了")
teat_a.py用例
def test_a(): '''用例描述:test_a''' print("上海-悠悠")
最终统计的结果: 1 passed, 1 error in 0.16 seconds
只获取call的结果
咱们在写用例的时候,若是保证setup和teardown不报错状况,只关注测试用例自己的运行结果,前面的 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) # 3. 从钩子方法的调用结果中获取测试报告 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 后置操做")
运行结果