pytest 4.6.7 发布解读修复 JUnit XML 报告结构与临时目录清理竞态问题【免费下载链接】pytestThe pytest framework makes it easy to write small tests, yet scales to support complex functional testing项目地址: https://gitcode.com/GitHub_Trending/py/pytestpytest 4.6.7 是 pytest 4.6 系列维护线的一个 bug-fix缺陷修复版本于 2019-12-05 发布到 PyPI属于可直接替换drop-in replacement的补丁版本。本次发布聚焦于两个关键修复--junitxml生成的 XML 报告现在正确包含testsuites根元素issue #5477以及临时目录清理时对FileNotFoundError的妥善忽略issue #6044。阅读本文后你将理解这两个修复的来龙去脉、如何在项目中安全升级 pytest并能结合当前仓库源码掌握 JUnit 报告生成与临时目录管理机制的底层实现。版本定位一次安全的缺陷修复pytest 4.6.7 的官方发布公告doc/en/announce/release-4.6.7.rst明确指出This is a bug-fix release, being a drop-in replacement.所谓 drop-in replacement可直接替换意味着它只修复缺陷、不引入破坏性变更在同一个主版本号段内升级不需要修改测试代码、插件配置或命令行参数。该版本的完整变更记录收录于仓库的 doc/en/changelog.rst其中 4.6.7 一节doc/en/changelog.rst#L5842-L5853列出了两项 Bug Fixes#5477--junitxml生成的 XML 文件现在正确包含testsuites根元素。#6044在尝试删除旧的临时目录时正确忽略FileNotFoundErrorPython 2 中为OSError.errno NOENT例如多个进程同时删除同一目录时常见于使用pytest-xdist并行执行的情况。发布公告同时向本版本的贡献者表达了感谢包括Bruno Oliveira与Daniel Hahler两位开发者。升级方式由于 4.6.7 是补丁版本且完全向后兼容升级只需通过 pip 更新到最新版本pip install --upgrade pytest升级完成后可以通过pytest --version校验安装的版本号。当前仓库中版本号的定义位于 src/_pytest/init.py它从_version模块导入__version__与version_tuple若安装损坏则回退为unknown并由pytest --version展示给用户。修复一#5477——JUnit XML 报告根元素修正问题背景JUnit XML 是 CI/CD 系统如 Jenkins、GitLab CI解析测试结果的标准格式。pytest --junitxmlpath命令把测试结果输出为 JUnit 风格的 XML 文件。在 4.6.7 之前该 XML 文件的根元素结构存在缺陷无法正确包含testsuites根元素导致部分严格校验 XML 结构的工具或平台无法正确识别报告。修复效果4.6.7 修复后--junitxml输出的 XML 以testsuites作为根元素符合 JUnit 规范。如果对当前仓库版本的输出做校验可以看到根元素还被赋予了namepytest tests属性这一增强来自后来的 issue #12736记录在 doc/en/changelog.rst 中并明确其基于junit-10.xsd规范。底层实现当前仓库的 JUnit 报告逻辑集中在 src/_pytest/junitxml.pyLogXML类负责构建整个 XML 树通过ET.Elementxml.etree.ElementTree组装testsuites→testsuite→testcase的层级结构_TestSuiteNode.to_xml()src/_pytest/junitxml.py#L156-L162负责把单个测试用例节点序列化为testcase元素并写入耗时time属性捕获输出与日志的写入由write_captured_output()src/_pytest/junitxml.py#L169-L190完成它会依据配置决定把捕获到的 stdout、stderr 与日志以system-out、system-err形式写入报告。相关配置项围绕 JUnit 报告pytest 提供了若干 ini 配置定义于 src/_pytest/junitxml.py#L404-L420可在pytest.ini或pyproject.toml的[tool.pytest.ini_options]中设置配置项默认值说明junit_suite_namepytestJUnit 报告中测试套件的名称junit_loggingno是否把捕获的日志写入报告可选no、log、system-out、system-err、out-err、alljunit_log_passing_testsTrue是否对通过的测试也记录捕获的输出设为False可减小报告体积junit_duration_report—测试耗时的统计口径例如在pytest.ini中[pytest] junit_family xunit2 junit_suite_name my_project junit_logging all junit_log_passing_tests False搭配命令行使用pytest --junitxmltest-results.xml修复二#6044——临时目录清理竞态问题问题背景pytest 为每个测试提供tmp_path/tmpdirfixture并在会话结束时清理这些临时目录。当测试通过pytest-xdist在多个进程中并行运行时多个进程可能同时尝试删除同一个临时目录一个进程删除了目录另一个进程再去删除时就会抛出FileNotFoundError导致整个 pytest 会话异常中断。修复效果4.6.7 修复后pytest 在清理旧临时目录时会正确忽略这类目录已被他人删除的异常。changelog 原文特别说明这是当多个进程尝试删除同一个目录时常见于pytest-xdist的典型场景在 Python 2 中FileNotFoundError尚不存在需要通过OSError.errno NOENT来识别同一类错误。底层实现当前仓库中临时目录的健壮性清理逻辑沉淀在 src/_pytest/pathlib.pyrm_rf()封装了shutil.rmtree调用并为 Python 3.12 传入onexc参数、其余版本传入onerror错误处理回调错误处理回调on_rm_rf_error()src/_pytest/pathlib.py#L108-L120中对FileNotFoundError明确返回False其源码注释直接写道Another process removed the file in the middle of the rm_rf (xdist for example)——即另一进程恰好在该进程清理中途删除了文件临时目录的管理入口是 src/_pytest/tmpdir.py 中的TempPathFactory它通过make_numbered_dir_with_cleanup、rm_rf等函数创建与回收会话级临时目录并通过ExitStack注册会话结束时的清理动作src/_pytest/tmpdir.py#L79-L81即使sessionfinish钩子因故未执行atexit兜底清理仍能生效。对使用者的影响对普通用户而言此修复消除了并行测试时的偶发崩溃对使用pytest-xdist的团队而言它显著提升了大规模测试在 CI 上的稳定性。涉及临时目录行为的命令行选项还包括--basetemp自定义会话级临时目录根路径它在 src/_pytest/tmpdir.py 中被解析为TempPathFactory的given_basetemp并参与目录的安全校验与保留策略tmp_path_retention_policy。如何在当前仓库中验证这两个修复如果你希望在当前仓库中验证这两处修复对应的实现可以按以下路径深入阅读JUnit 报告结构src/_pytest/junitxml.py 中的LogXML类与write_captured_output()方法配合pytest --junitxmlout.xml运行任一测试后查看out.xml的根元素临时目录清理src/_pytest/pathlib.py 中on_rm_rf_error()对FileNotFoundError的处理分支以及 src/_pytest/tmpdir.py 中TempPathFactory的注册与清理流程完整变更记录仓库根目录的 doc/en/changelog.rst 收录了包括 4.6.7 在内的全部历史版本变更可作为回溯各版本修复的权威依据所有历史版本公告可参见 doc/en/announce/index.rst。小结pytest 4.6.7 虽然只是 4.6 系列的一个小补丁但它的两个修复分别触及了测试框架的两条关键链路对外输出JUnit XML 报告的规范性与平台兼容性和对内管理临时目录的生命周期与并发安全。理解这两个修复既能帮助你在升级 pytest 时从容验证也能让你在阅读当前仓库源码时快速定位 JUnit 报告与临时目录清理这两大基础设施的核心实现。【免费下载链接】pytestThe pytest framework makes it easy to write small tests, yet scales to support complex functional testing项目地址: https://gitcode.com/GitHub_Trending/py/pytest创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考