Allure 是一个开源的、轻量级且灵活的测试报告框架,旨在为各种测试框架生成美观、交互式的测试报告。它能够与 Python 测试框架(如 Pytest)完美结合,为测试人员提供丰富且易于理解的测试结果展示。
下面简单介绍一下Allure的安装和使用。
环境准备
使用allure需要安装JDK 1.8+ 及python 3,请先确保这两个包已经正确安装,查询命令如下:
C:\Users\Luke>java -version
java version "23.0.2" 2025-01-21
Java(TM) SE Runtime Environment (build 23.0.2+7-58)
Java HotSpot(TM) 64-Bit Server VM (build 23.0.2+7-58, mixed mode, sharing)C:\Users\Luke>python --version
Python 3.13.2C:\Users\Luke>
安装可以参考链接:
Java(JDK)下载安装与环境配置-Windows 10 图文版教程 - 知乎
超详细的Python安装和环境搭建教程_python安装教程-CSDN博客
第一步,下载allure
https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/
选择一个版本(windows下载.zip包就可以),下载完直接解压就好了,记住你放置解压包的路径。
第二步,配置allure系统环境变量
【计算机--属性--高级系统设置--环境变量--系统变量--path--编辑】
环境变量添加刚才解压时allure目录中bin文件的路径
第三步,验证环境变量配置是否成功
打开cmd终端命令行,输入:allure
第四步,安装allure-pytest
C:\Users\Luke>
C:\Users\Luke>pip install allure-pytest
Requirement already satisfied: allure-pytest in d:\program files\lib\site-packages (2.13.5)
Requirement already satisfied: pytest>=4.5.0 in d:\program files\lib\site-packages (from allure-pytest) (8.3.5)
Requirement already satisfied: allure-python-commons==2.13.5 in d:\program files\lib\site-packages (from allure-pytest) (2.13.5)
Requirement already satisfied: attrs>=16.0.0 in d:\program files\lib\site-packages (from allure-python-commons==2.13.5->allure-pytest) (25.3.0)
Requirement already satisfied: pluggy>=0.4.0 in d:\program files\lib\site-packages (from allure-python-commons==2.13.5->allure-pytest) (1.5.0)
Requirement already satisfied: colorama in d:\program files\lib\site-packages (from pytest>=4.5.0->allure-pytest) (0.4.6)
Requirement already satisfied: iniconfig in d:\program files\lib\site-packages (from pytest>=4.5.0->allure-pytest) (2.0.0)
Requirement already satisfied: packaging in d:\program files\lib\site-packages (from pytest>=4.5.0->allure-pytest) (24.2)[notice] A new release of pip is available: 24.3.1 -> 25.0.1
[notice] To update, run: python.exe -m pip install --upgrade pipC:\Users\Luke>pip show allure-pytest
Name: allure-pytest
Version: 2.13.5
Summary: Allure pytest integration
Home-page: https://allurereport.org/
Author: Qameta Software Inc., Stanislav Seliverstov
Author-email: sseliverstov@qameta.io
License: Apache-2.0
Location: D:\Program Files\Lib\site-packages
Requires: allure-python-commons, pytest
Required-by:C:\Users\Luke>
第五步,运行用例时使用allure生成报告
运行 pytest.main(['--alluredir=reports/allure_result']) ,生成的是一系列json文件
需要在终端运行命令:allure generate reports/allure_result -o reports/allure_report --clean
PS C:\Users\Luke\PycharmProjects\request_test> allure generate reports/allure_result -o reports\allure_report --clean
Report successfully generated to reports\allure_report
PS C:\Users\Luke\PycharmProjects\request_test>
此时你会发现reports下生成了一个新的文件夹allure_report。
注意,如果直接双击打开allure_report下的index.html,会出现所有结果都是loading的情况,这是因为直接allure报告用浏览器是打不开的,需要用allure命令渲染之后打开才能展示效果(allure常识)。
故而在控制台使用allure open命令来渲染并打开。
PS C:\Users\Luke\PycharmProjects\request_test> allure open reports\allure_report
Starting web server...
Server started at <http://127.0.0.1:63664>. Press <Ctrl+C> to exit
查看结果如下:
这个界面可以进一步的丰富和更新。