本文详细介绍了如何定制 `pytest-html` 生成的 html 测试报告的文件名，包括使用 `--html` 选项指定静态文件名，以及结合 shell 命令（如 `date`）实现动态、带时间戳的文件命名，以避免报告文件被覆盖。此外，还强调了使用 `--self-contained-html` 选项生成独立报告的重要性，确保每个报告及其所有资产都封装在一个文件中，避免多份报告共享资产文件夹的问题。
1. Pytest-HTML报告文件名定制概述
pytest-html 插件默认会在每次测试运行后生成一个名为 report.html 的测试报告。尽管可以通过 conftest.py 中的 pytest_html_report_title 钩子修改报告内部的标题，但这并不能改变实际的文件名，导致每次运行都会覆盖之前的 report.html 文件。为了解决这个问题，pytest-html 提供了一个命令行选项 --html，允许用户自定义报告的输出路径和文件名。
2. 指定静态报告文件名
要将 pytest-html 生成的报告保存为自定义的文件名，只需在运行 pytest 命令时，通过 --html 选项指定所需的文件路径和名称。
示例：
假设我们想将报告命名为 mycustomreport.html。
立即学习“前端免费学习笔记（深入）”；
# 检查当前目录下是否存在html文件 $ ls | grep -c "html" 0 # 运行pytest并指定报告文件名 $ pytest --html=mycustomreport.html tests/ # ... (pytest测试运行输出) ... # - Generated html report: file:/path/to/mycustomreport.html - # 再次检查，确认新文件已生成 $ ls | grep -c "html" 1 $ ls | grep "html" mycustomreport.html
通过这种方式，每次运行 pytest，报告都会被保存为 mycustomreport.html。如果该文件已存在，则会被新生成的报告覆盖。
3. 实现动态、带时间戳的报告文件名
为了避免报告文件被覆盖，并为每次测试运行生成唯一的报告，我们可以结合 shell 命令（如 Linux/macOS 的 date 命令）来动态生成带有时间戳的文件名。
示例：
使用 date 命令生成 YYYYMMDD_HHMMSSZ_report.html 格式的文件名。
# 检查当前目录下是否存在html文件 $ ls | grep -c "html" 0 # 第一次运行，生成带时间戳的报告 $ pytest --html="$(date +%Y%m%d_%H%M%SZ)_report.html" tests/ # ... (pytest测试运行输出) ... # 第二次运行 $ pytest --html="$(date +%Y%m%d_%H%M%SZ)_report.html" tests/ # ... (pytest测试运行输出) ... # 第三次运行 $ pytest --html="$(date +%Y%m%d_%H%M%SZ)_report.html" tests/ # ... (pytest测试运行输出) ... # 检查生成的文件 $ ls | grep -c "html" 3 $ ls | grep "html" 20240106_171151Z_report.html 20240106_171202Z_report.html 20240106_171206Z_report.html
每次运行 pytest 命令时，$(date +%Y%m%d_%H%M%SZ) 会被替换为当前的日期和时间，从而生成一个独一无二的文件名。这在持续集成/持续部署 (CI/CD) 环境中尤其有用，可以保留每次构建的测试报告历史。
4. 生成独立（Self-Contained）的HTML报告
当生成多个动态命名的 HTML 报告时，可能会出现一个问题：所有报告默认会共享同一个 assets 文件夹。这意味着如果删除了某个报告对应的 assets 文件夹，或者在不同时间查看不同的报告，其样式和脚本可能会出现问题。
为了确保每个报告都是完全独立的，建议使用 --self-contained-html 选项。此选项会将所有必要的 CSS 样式、JavaScript 脚本和图像等资产直接嵌入到 HTML 文件中，从而生成一个单一的、无需外部依赖的报告文件。
示例：
结合动态文件名和独立报告选项。
$ pytest --html="$(date +%Y%m%d_%H%M%SZ)_report.html" --self-contained-html tests/ # ... (pytest测试运行输出) ... # - Generated html report: file:/path/to/20240106_171206Z_report.html -
使用 --self-contained-html 后，即使将报告文件移动到其他位置，或者删除其他相关文件，报告也能正常显示，这对于报告的归档和分享非常有益。
5. 注意事项
- --html 选项的文档情况： 尽管 --html 选项在 pytest-html 插件中是可用的，但在某些版本（例如 pytest-html 4.1.1）的官方文档中可能没有明确提及。然而，它在插件的源代码中是明确定义的，并作为核心功能存在。
- Shell 命令兼容性： 动态命名报告文件时，请确保所使用的日期/时间命令在您的操作系统或 CI/CD 环境中是可用的。date 命令在类 Unix 系统（Linux, macOS）中普遍存在。对于 Windows 环境，可能需要使用不同的方法或 PowerShell 命令来获取时间戳。
总结
通过灵活运用 pytest-html 插件提供的 --html 命令行选项，我们可以轻松地定制测试报告的文件名。结合 shell 命令实现动态命名，可以有效地管理多份测试报告，避免文件覆盖。更进一步，使用 --self-contained-html 选项能够生成完全独立的报告文件，极大地提高了报告的可移植性和可靠性。这些技巧对于构建健壮的自动化测试报告系统至关重要。
