### Python Pytest 获取测试用例执行结果的方法 在 `pytest` 中，可以通过自定义钩子函数 `pytest_runtest_makereport` 来捕获每个测试用例的执行结果。此方法允许开发者访问测试报告对象，并从中提取有用的信息，例如测试状态 (`passed`, `failed`, 或 `skipped`) 和其他元数据。 以下是实现该功能的具体方式： #### 自定义 `pytest_runtest_makereport` 通过覆盖默认的 `pytest_runtest_makereport` 钩子函数，可以拦截并处理每次测试用例的执行结果。下面是一个完整的例子，展示如何记录测试结果到日志文件中[^1]。 ```python # conftest.py 文件中的配置 import pytest @pytest.hookimpl(hookwrapper=True) def pytest_runtest_makereport(item, call): outcome = yield # 调用原始的 pytest_runtest_makereport 函数 report = outcome.get_result() # 获取测试报告 if report.when == 'call': # 只关注测试主体部分 (忽略 setup 和 teardown) with open("test_results.log", "a") as log_file: log_file.write(f"Test Name: {report.nodeid}\n") log_file.write(f"Description: {str(item.function.__doc__)}\n") log_file.write(f"Outcome: {report.outcome}\n\n") ``` 上述代码片段实现了以下功能： - 使用 `hookwrapper=True` 参数包裹原生的 `pytest_runtest_makereport` 方法。 - 在 `yield` 后获取测试报告对象 `report`。 - 判断当前阶段是否为 `'call'`（即实际测试逻辑运行的部分），从而过滤掉无关的日志信息。 - 将测试名称、描述以及最终结果写入名为 `test_results.log` 的文件中[^2]。 #### 测试用例示例 为了验证以上机制的有效性，编写几个简单的测试用例作为输入样本。 ```python # test_example.py def test_success(): """This is a successful test.""" assert True def test_failure(): """This is a failing test.""" assert False def test_skip(): """This is a skipped test.""" pytest.skip("Skipping this test.") ``` 当运行这些测试时，成功/失败的状态会被自动保存至指定的日志文件中。 --- ### 关键参数说明 - **`item`**: 表示单个测试项的对象实例，包含了诸如节点 ID(`nodeid`) 和文档字符串等属性。 - **`call`**: 描述了当前所处的生命周期阶段(如设置环境、执行核心业务逻辑或清理资源)，其值通常为 `'setup'`, `'call'`, 或者 `'teardown'`. - **`outcome`**: 存储着整个测试流程的结果摘要，可能取值有 `"passed"`、`"failed"` 或 `"skipped"`. 更多关于命令行选项的内容也可以参考官方指南来进一步定制化行为[^3]. --- ### 注意事项 尽管能够轻松收集每条测试案例的表现情况，但在大规模项目环境下需注意性能开销问题；频繁读写外部存储介质可能会拖慢整体进度。因此建议仅针对必要场景启用此类特性[^4]。 ---