Allure05-用例描述详解

最新推荐文章于 2025-12-10 16:04:23 发布
原创 最新推荐文章于 2025-12-10 16:04:23 发布 · 651 阅读 · 10 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#pycharm #pytest #python

Allure05-用例描述详解

高清视频B站链接


作用：提高测试报告的可读性，减少团队沟通成本，提升工作效率

1.Allure添加用例步骤描述详解
例子：
用例步骤：
1.登陆 2.浏览商品 3.添加购物车 4.生成订单 5 完成支付

1）将用例步骤做关键字封装
2）开始用例设计，登陆单独拿出来，当成前置操作，后面的步骤合起来成为一个用例

测试步骤也可以在封装的函数上加上装饰器实现：@allure.step()

两种方式对比：
使用 with allure.step(“step:步骤”) 这种方式代码可读性更好一点，
但不会带上函数里面的传参和对应的值。
使用 @allure.step(“step:步骤”) 这种方式会带上函数的传参和对应的值。
这两种方式结合起来使用，才能更好的展示测试报告！

测试技术交流请联系我
在这里插入图片描述
备注优快云扶摇

【学习软件测试/Python自动化测试技术/领取Python自动化测试学习路线图/简历优化】
视频链接：
课程服务介绍

自动化全栈学习路线图讲解

软件测试面试合集

Python编程刷题合集

Pytest入门到实战

Python接口自动化合集

PythonWeb自动化合集

性能测试合集

Jmeter接口自动化测试实战全集

2023GPT探索发现合集

2024Pytest合集

加微信（备注优快云扶摇）即可免费领取下面的自动化测试资料和一份软件测试面试宝典
在这里插入图片描述
在这里插入图片描述

【2024软件测试面试必会技能】allure测试报告(3): allure测试报告的用例描述设置
02-21 1370
2023最新自动化测试自学教程新手小白26天入门最详细教程,目前已有300多人通过学习这套教程入职大厂！！_哔哩哔哩_bilibili2023最新合集Python自动化测试开发框架【全栈/实战/教程】合集精华，学完年薪40W+_哔哩哔哩_bilibili​​​​​​也方便你下次能够快速查找。如有不懂还要咨询下方小卡片，博主也希望和志同道合的测试人员一起学习进步在适当的年龄，选择适当的岗位，尽量去发挥好自己的优势。我的自动化测试开发之路，一路走来都离不每个阶段的计划，因为自己喜欢规划和总结，
Pytest-Allure及Allure命令使用
qq_37954088的博客
11-02 3116
Allure是Pytest用于生成测试报告的框架，提供丰富的测试报告功能； 详细介绍pytest-allure、allure命令行导出报告。
pytest--allure报告中添加用例详情
2301_77645573的博客
03-14 1509
前面介绍了如何生成allure的报告，看着allure的页面非常好看，但是感觉少了一些内容，allure还可以增加一些用例详情内容，这样让我们的报告看着更加绚丽。自动化测试用例都是通过功能用例转换过来的，我们也可以通过allure将我们的测试用例相关的链接到我们的自动化测试用例中，并通过allure展示出来，这里可以通过 @allure.issue() 进行添加bug缺陷内容， @allure.testcase() 添加测试用例链接@allure.title('登录用户')'''登录用户'''
【自动化基础】allure描述用例详细讲解及实战
软件测试技术交流分享
09-02 392
allure可以输出非常精美的测试报告，也可以和pytest进行完美结合，不仅可以渲染页面，还可以控制用例的执行。下面就对allure的使用进行一个详细的介绍和总结。
软件测试学习笔记丨Allure2报告中添加用例描述
Ceshiren666的博客
03-25 341
应用场景：Allure 支持往测试报告中对测试用例添加非常详细的描述语，用来描述测试用例详情。方式三：直接在测试用例方法中通过编写文档注释的方法来添加描述。传递一段 HTML 文本来描述测试用例。方式四：用例代码内部动态添加描述信息。传递一个字符串参数来描述测试用例。
26-pytest-allure描述用例详解
小白的博客
03-19 591
pytest-allure描述用例详解
pytest框架--allure报告用例参数详解
weixin_45422695的博客
12-07 1003
原文链接：http://www.manongjc.com/detail/18-uxknglitylthfjx.html 1、案例描述： #test_allure_demo.py import pytest import allure @pytest.fixture(scope="session") def login(): print("前置条件：登录") @allure.step("步骤1") def step_1(): print("操作步骤----1") @allure.step(
pytest篇13-allure描述用例详解
m0_47127594的博客
05-15 898
01—引言很久没有更新文章了。上一次更新了allure报告中怎么修改环境参数信息，今天总结一下allure中描述用例的详细规则运用。02—用例描述使用方法参数值参数说明@allure.ep...
python allure-python库使用详解
Hacker_Fuchen的博客
10-29 739
Allure 支持多种预定义的严重性级别，如 "blocker"（阻塞性）、"critical"（关键）、"normal"（正常）、"minor"（次要）、"trivial"（琐碎）。标签可以用来标记测试的特定属性，如测试类型（功能测试、回归测试、性能测试等）、测试环境（生产、 staging、开发等）、测试阶段（冒烟测试、集成测试、系统测试等）、责任人等。对于 unittest 和 nose，需要在测试代码中导入相应的 Allure 插件，并在测试类或模块中启用：​​​​​​。
allure-2.17.13.zip
03-20
《Allure报告框架详解及其2.17.13版本特性》 Allure是一个功能强大的测试报告工具，专为各种自动化测试框架设计，提供了一种美观、易读且丰富的测试结果展示方式。Allure报告以其直观的图表和详细的信息，帮助...
allure-2.18.1.zip
07-22
《Allure报告框架详解——基于allure-2.18.1.zip的解析》 Allure是一款强大的测试报告工具，其2.18.1版本的zip包包含了全面的功能和丰富的资源，旨在为软件测试过程提供美观且详尽的报告。在本文中，我们将深入探讨...
allure-commandline压缩文件
12-27
《Allure Commandline工具详解与使用》 在软件测试领域，报告工具的使用至关重要，它能够帮助我们清晰地理解测试结果，找出问题所在。其中，Allure Framework是一款强大的、直观的测试报告工具，而Allure Command...
allure-2.13.2.zip
01-04
《Allure自动化测试报告软件详解》 在软件测试领域，测试报告是衡量测试效果和进度的重要依据，它能够清晰地展示测试过程中的各种数据和结果。Allure是一款强大的、直观的自动化测试报告工具，旨在提供一种更加人性...
深度学习1.3-软件篇-2025Pycharm添加导入anaconda中虚拟环境的python解释器以及相关Error解决方案
诚朴勇毅
12-05 340
首先用anaconda配置一个所需的环境，然后我们在pyCharm中的编辑好之后需要将之前配置的环境用作解释器。4. 如下图，环境导入成功！
pycharm 12月最新2025.3 安装、授权、使用说明
最新发布
oHenZiJue的博客
12-10 108
新版本安装后不提示授权，需要手动到设置中授权处理。如有疑问，可到 👆👆👆👆👆👆 进行咨询。已经安装好的在线更新到最新版本即可。打开自己的项目，配置环境，开始开发。
YOLOv8安装部署全流程指南（PyCharm实战版）
caizikid的博客
12-08 635
以下是完整的YOLOv8安装部署全流程指南（PyCharm实战版），整合最新实测资源与操作技巧，包含环境配置、数据集制作、训练调试到多平台部署全流程： 2. 安装核心依赖（匹配CUDA 12.1） 二、数据集制作（PyCharm集成） 1. 标注工具集成 2. 数据集结构示例 三、模型训练（PyCharm调试） 1. 创建训练脚本 2. 数据集配置文件 3. 实时监控（TensorBoard） 四、模型导出与部署 1. 导
在 Pycharm 中 debug Scrapy 项目
codists的博客
12-08 548
为什么写这篇文章呢？因为自己想在 Scrapy 项目里 debug, 看看 Response 有哪些属性。当然，如果熟悉 VSCode 的人看到这个配置就明白其实执行方式是：python -m scrapy runspider xxx_spider.py (注：这里的 xxx_spider.py 指 spider 文件，如官方文档里面的 quotes_spider.py)。
pycharm加载anaconda环境失败，无pytho解释器解决方案
诚朴勇毅
12-09 368
后面的文件地址是灰色表示的，它正确的指向了python.exe文件，而这个文件就是anaconda配置好的虚拟环境后再env文件夹中生成的虚拟环境的文件夹，里面包含了这个exe文件。我理解的是这个python就是你最终编译程序的时候的python解释器。
pycharm 12月最新2025.2.5 安装、授权、使用说明
oHenZiJue的博客
12-08 276
从 PyCharm 2025.1 开始，PyCharm Community 和 Professional 将合并为一个统一的产品： PyCharm。通过此更改，所有用户都可以访问基本功能，无需在不同版本之间切换。
import pytest import os pytest.main() # 启动测试框架, 自动生成allure数据 os.system('allure generate -c -o report allure-results') # 手动生成allure报告
09-28
<think>我们已知用户想要了解如何使用pytest.main启动测试框架并自动生成Allure数据，以及如何使用os.system调用allure generate生成报告。同时，用户提到了可能遇到的问题，如allure指令调用失败。 根据引用[1]、[2]、[3]： - 引用[1]指出，需要在测试执行后使用os.system调用allure指令来生成报告，但可能失败。 - 引用[2]提供了基本的命令：使用pytest运行测试并指定alluredir存放结果，然后使用allure generate生成报告。 - 引用[3]给出了一个具体的pytest命令示例。 因此，我们可以构建一个完整的流程： 1. 使用pytest.main运行测试，并指定--alluredir参数来生成Allure的原始数据（json/txt文件）。 2. 使用os.system调用allure generate命令将原始数据转换为HTML报告。 步骤详解： ### 步骤1：运行测试并生成Allure原始数据 在测试脚本中，我们可以使用`pytest.main()`来运行测试，并传递参数。例如： ```python import pytest if __name__ == '__main__': # 指定测试用例目录或文件，以及生成allure报告的原始数据目录 pytest.main(['TestCase/test_search.py', '--alluredir', './allure-results']) ``` ### 步骤2：使用allure generate生成HTML报告 在测试运行完成后，调用allure命令行工具生成报告： ```python import os # 生成报告到指定目录（例如：./report） os.system('allure generate ./allure-results -o ./report --clean') ``` ### 完整示例代码 ```python import pytest import os if __name__ == '__main__': # 1. 运行测试并生成Allure原始数据 pytest.main(['-v', '--alluredir', './allure-results']) # 2. 生成Allure报告 os.system('allure generate ./allure-results -o ./report --clean') ``` ### 常见问题及解决方案 1. **allure命令不存在**： - 确保已安装Allure命令行工具。安装方法参考[官方文档](https://docs.qameta.io/allure/#_installing_a_commandline)。 - 在命令行中执行`allure --version`检查是否安装成功。 - 如果安装成功但os.system调用失败，可能是因为环境变量未配置。可以尝试使用绝对路径调用allure命令（例如：在Windows上可能是`C:\Users\username\allure\bin\allure.bat`，在Linux/macOS上可能是`/usr/local/bin/allure`）。 2. **报告生成失败**： - 检查`./allure-results`目录是否存在且包含数据（json文件）。如果没有，说明测试运行未生成数据，需要检查pytest运行是否成功。 - 使用`--clean`参数可以清除之前的报告，避免旧数据干扰。 3. **报告无法打开**： - 生成的报告是静态HTML文件，可以使用allure open命令在本地服务器打开： ```python os.system('allure open ./report') ``` - 或者直接在文件系统中打开`./report/index.html`（注意：部分浏览器可能因安全限制无法直接打开，建议使用HTTP服务器）。 4. **测试执行与报告生成分离**： - 可以在不同机器上执行测试和生成报告，只需将`allure-results`目录复制到有allure命令行工具的机器上。 ### 使用配置文件（可选） 为了提高可维护性，可以将配置放在`pytest.ini`文件中，例如： ```ini [pytest] addopts = -v --alluredir=./allure-results ``` 然后在主脚本中简化调用： ```python pytest.main() # 会自动读取pytest.ini中的配置 ``` ### 流程总结 $$ \begin{array}{c} \text{运行测试} \\ \downarrow \\ \text{生成Allure原始数据（--alluredir）} \\ \downarrow \\ \text{调用allure generate生成HTML报告} \end{array} $$ ### 相关问题 1. 如何将Allure报告集成到持续集成（CI）系统中？ 2. 如何在测试失败时自动附加截图或日志到Allure报告？ 3. 如何自定义Allure报告的样式和内容？ 4. 如何解决Allure命令在系统路径中不可用的问题？ 5. 如何定时清理历史生成的Allure报告数据？ [^1]: 因为pytest下的allure测试报告生成，需要调用allure指令，这个指令和pytest没有关系，所以想要一步实现数据的记录以及报告的生成，记得添加os.system()方法来调用allure指令。但是，可能allure指令调用会失败。 [^2]: allure文档 :Allure Framework 安装 allure-pytest插件 pip install allure-pytest 生成Allure报告 运行 pytest [测试文件] -s -q --alluredir=./result #--alluredir用于指定存储测试结果的路径。 [^3]: Pytest使用allure测试报告。生成allure原始报告到report/allure目录下，生成的全部为json或txt文件。 pytest TestCase/test_search.py --alluredir ./allure。 </think>### 使用 Pytest 生成 Allure 报告完整指南 #### 核心流程（三步法） $$ \begin{array}{c} \text{安装依赖} \\ \downarrow \\ \text{测试执行 + 数据生成} \\ \downarrow \\ \text{报告生成与服务启动} \end{array} $$ --- #### 1. 环境准备 ```bash # 安装必备组件 pip install pytest allure-pytest ``` #### 2. 测试执行与数据生成（Python 脚本） ```python import pytest import os if __name__ == "__main__": # 步骤1: 执行测试并生成Allure原始数据 pytest.main([ 'test_cases/', # 测试用例目录 '-v', # 详细输出 '--alluredir=./results' # 指定原始数据目录[^2] ]) # 步骤2: 生成HTML报告 os.system('allure generate ./results -o ./report --clean') # 步骤3: 自动打开报告（可选） os.system('allure open ./report') ``` #### 3. 命令行直接执行 ```bash # 生成测试数据 pytest test_cases/ --alluredir=./results # 生成HTML报告 allure generate ./results -o ./report --clean # 启动本地报告服务 allure open ./report ``` --- ### 关键参数说明 | 参数 | 作用 | 示例 | |------|------|------| | `--alluredir` | 指定原始数据目录 | `--alluredir=./logs` | | `-o` | 指定报告输出目录 | `-o ./html_report` | | `--clean` | 清理历史报告 | 确保最新数据 | | `allure open` | 启动Web服务 | 默认端口8080 | --- ### 常见问题解决方案 #### 1. Allure 命令调用失败 **现象**：`'allure' 不是内部或外部命令` **解决方案**： ```bash # Windows系统需配置环境变量 set PATH=%PATH%;C:\path\to\allure\bin # 或使用绝对路径（Python示例） os.system('C:/allure/bin/allure generate ...') ``` #### 2. 报告数据为空 **排查步骤**： 1. 检查`./results`目录是否生成文件 2. 确认测试用例包含`@allure`装饰器： ```python import allure @allure.title("登录功能测试") def test_login(): allure.attach("测试数据", "username=test") assert login() == True ``` #### 3. 跨平台路径问题 **解决方案**：使用`pathlib`模块 ```python from pathlib import Path results_dir = Path('./results').resolve() report_dir = Path('./report').resolve() os.system(f'allure generate {results_dir} -o {report_dir}') ``` #### 4. 历史报告残留 **解决方案**：添加清理参数 ```python os.system('allure generate ./results -o ./report --clean') ``` --- ### 最佳实践建议 1. **目录结构示例**： ``` project/ ├── test_cases/ ├── results/ # 原始数据 └── report/ # HTML报告 ``` 2. **CI/CD 集成**： ```yaml # GitHub Actions 示例 - name: Generate Report run: | allure generate ${{ github.workspace }}/results -o ${{ github.workspace }}/report if: ${{ always() }} # 测试失败时仍生成报告 ``` 3. **动态文件名**（带时间戳）： ```python import datetime timestamp = datetime.datetime.now().strftime("%Y%m%d_%H%M") os.system(f'allure generate ./results -o ./report_{timestamp}') ``` --- ### 技术原理 $$ \begin{array}{c} \text{Pytest执行} \\ \downarrow \\ \text{Allure监听器捕获数据} \\ \downarrow \\ \text{生成JSON/TXT原始文件} \\ \downarrow \\ \text{allure generate编译为HTML} \end{array} $$ [^1]: pytest通过allure-pytest插件在测试执行时收集数据[^2] --- ### 相关问题 1. 如何在 Allure 报告中添加自定义环境信息？ 2. 测试失败时如何自动附加截图到 Allure 报告？ 3. 如何在 Jenkins 中集成 Allure 报告可视化？ 4. 如何解决 Allure 报告中的历史趋势数据丢失问题？ 5. 如何定制 Allure 报告的主题和样式？ [^1]: 因为pytest下的allure测试报告生成，需要调用allure指令，这个指令和pytest没有关系，所以想要一步实现数据的记录以及报告的生成，记得添加os.system()方法来调用allure指令。但是，可能allure指令调用会失败。 [^2]: allure文档 :Allure Framework 安装 allure-pytest插件 pip install allure-pytest 生成Allure报告 运行 pytest [测试文件] -s -q --alluredir=./result [^3]: Pytest使用allure测试报告。生成allure原始报告到report/allure目录下，生成的全部为json或txt文件。 pytest TestCase/test_search.py --alluredir ./allure。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

测试老宅男扶摇

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值