PyTest+Allure生成测试报告

一、官方文档（权威）

1. Allure Report 官网：Allure Report Docs — Introduction

2. Allure GitHub地址：GitHub - allure-framework/allure2: Allure Report is a flexible, lightweight multi-language test reporting tool. It provides clear graphical reports and allows everyone involved in the development process to extract the maximum of information from the everyday testing process

3. Allure系列仓库：https://github.com/orgs/allure-framework/repositories 

4. 报告样式：Allure Report

二、 什么是Allure Report

Allure Report是一款流行的开源工具，用于可视化测试运行的结果。它几乎不需要任何配置即可添加到您的测试工作流程中。它生成的报告可以在任何地方打开，任何人都可以阅读，无需深厚的技术知识。

• 作为 QA 分析师，您可以根据需要筛选和排序测试结果，让测试结果分析更轻松、更有效。将结果与之前的运行进行比较。查找不稳定的测试。使用缺陷类别分析缺陷在测试结果中的分布情况。

• 作为开发人员，查看错误消息、堆栈跟踪和其他调试信息。通过将测试拆分为多个步骤或附加运行时数据（例如屏幕截图、日志或其他任何内容）来丰富测试的输出。如果测试执行多次，请查看每次尝试的详细信息。使用时间线工具查找测试的性能和并行化问题。

• 作为经理，跟踪整个项目或单个功能和测试套件的质量。使用可视化分析工具查看项目质量随时间的变化情况。测试报告易于打开、易于阅读且支持多种语言环境。

Allure有何不同

与特定于框架的报告工具不同，Allure Report 支持多种语言和框架，并允许您使用它们的任意组合。例如，如果您必须分别运行后端和前端测试，您仍然可以将所有结果转换为单个测试报告 - 并更好地了解项目中正在发生的事情。

同时，Allure Report 拥有一个完整的生态系统，可集成各种测试框架和库。它们会使用一些现成的数据来增强报告，并为您提供 API 以添加更多数据。查看您最喜欢的框架或库是否受支持。

Allure Report 以最简单但灵活的形式处理测试结果：仅文件。无需依赖报告服务器在执行期间在线 - 事实上，根本不需要通过网络发送任何数据。只需将 Allure Report 指向一个目录，它就会从中读取测试结果。

最后，Allure Report 非常易于集成。您无需更改测试工作流程即可开始使用它。一次运行或多次运行，在线或离线，在一台机器或一个集群上 - 支持任何配置，开放数据格式允许您根据需要扩展工作流程。

开始使用 Allure

• 最快的启动方式： 安装 Allure Report，按照与现在相同的方式运行测试，确保获得支持格式的结果，然后运行 ​​Allure Report将这些结果转换为漂亮的 HTML 报告。

• 准备好了吗？安装其中一个Allure 适配器- 特定于框架的库，可在测试期间收集更多数据。使用适配器提供的 API 可启用高级 Allure 功能，如步骤、附件、测试层次结构等。

• 需要更全面的信息？请考虑使用Allure TestOps — 我们的付费产品，它允许您跟踪手动和自动测试用例，汇总来自各种来源的测试结果，并在多个发布和项目中对其进行分析。

二、安装allure (MACOS)。

参考官网如何安装

终端执行命令：

brew install allure

安装完成后再执行下面的命令，如果出现版本号，说明安装成功

allure --version

笔者安装时的最新版本是2.30.0

三、安装allure-pytest插件

将allure pytest添加到现有的的项目中。（代表您有使用pytest测试框架写的自动化测试用例）。进入您的项目目录。执行以下命令安装allure-pytest

官网安装教程

pip3 intall allure-pytest

四、运行测试

命令行方式运行：

python -m pytest --alluredir allure-results

这会将必要的数据保存到测试结果目录中。如果目录已经存在，新文件将添加到现有文件中，以便将来的报告将基于所有文件。

pycharm中运行

    pytest.main(['-vs', './testcase/test_setting.py', '--clean-alluredir','--alluredir=allure-results'])

五、生成报告

最后，运行 Allure 将测试结果转换为 HTML 报告。这将自动打开浏览器来查看报告。

allure serve allure-results

报告中各目录的含义：

1.Overview:整体数据显示。

2.Categories：“类别”选项卡提供了创建自定义缺陷分类以应用测试结果的方法。

3.Suites:用例集合,按照套件和类分组的已执行测试的标准结构表示形式。

4.Graphs：用图表显示测试数据中收集的不同统计数据，状态分解或严重性和持续时间图。

5.Timeline：时间轴选项卡可视化测试执行的回顾，allure适配器收集测试的精确时间，在这个选项卡上，它们相应地按照顺序或并行的时间结构排列。

6.Behaviors：对于行为驱动的方法，此选项卡根据Epic、Feature和Story标记对测试结果进行分组。

7.Packages：软件包选项卡表示测试结果的树状布局，按不同的包名分组。

其他关于allure+pytest的文章：

pytest + allure生成测试报告 — 测试开发小记 0.1.0 文档

最全的Pytest+Allure使用教程，建议收藏-CSDN博客