当前位置：首页 > news >正文

接口自动化测试框架实战（Pytest+Allure+Excel）

news 文章来源：https://blog.csdn.net/zhangsiyuan1998/article/details/140023494 2025/1/16 8:00:34

🍅 视频学习：文末有免费的配套视频可观看

🍅 点击文末小卡片，免费获取软件测试全套资料，资料在手，涨薪更快

1. Allure 简介

Allure 框架是一个灵活的、轻量级的、支持多语言的测试报告工具，它不仅以 Web 的方式展示了简介的测试结果，而且允许参与开发过程的每个人可以从日常执行的测试中，最大限度地提取有用信息。

Allure 是由 Java 语言开发的，支持 Pytest，JaveScript、PHP、Ruby 等。

从 DEV/QA 的角度来看，Allure 提供了详尽的测试报告，比如简化了常见缺陷的统计；失败的测试可以分为 bug 和被中断的测试；还可以配置日志、步骤、fixture、附件、计时、执行历史；以及与 TMS、BUG 管理系统、Jenkins 集成等。所以，通过以上配置，所有负责的开发人员和测试人员可以尽可能地掌握测试信息。
从管理者的角度来看，Allure 提供了一个清晰的“大图”，即 High Level 的统计报告，其中包括已覆盖的特性、缺陷聚集的位置、执行时间轴的外观以及许多其他方便的事情。Allure 的模块化和可扩展性保证了你总是能够对某些东西进行微调，使得 Allure 更适合你。

那么下面就来说说如何使报告更加详细的显示我们需要的信息，以及 Allure 与 Jenkins 的集成。

安装（Windows/Mac 通用安装方法）

下载地址：https://github.com/allure-framework/allure2/releases，下载所需版本的 zip 包。

安装：

解压 —> 进入 bin 目录 —> 运行 allure.bat
把 bin 目录加入 Path 环境变量
配合 pytest，使用 allure2 生成更加精美的测试报告：pip install allure-pytest

运行方法

在测试执行期间收集结果

pytest [测试文件] -s -q --alluredir=./result/ --clean-alluredir

-s：表示将执行成功的案例日志打印出来
-q：若跟文件执行路径则代表只需要执行的文件
--alluredir：指定存储测试结果的路径（若目录不存在则会新建）
--clean-alluredir：清除历史结果数据

查看测试报告

方式一：用于在本地渲染后对外展示结果

allure serve ./result/

方式二：用于在本地渲染和查看结果

# 生成报告
allure generate ./result/ -o ./report/ --clean # 注意：覆盖路径加 --clean

# 打开报告
allure open -h 127.0.0.1 -p 8883 ./report/

注意：/report/ 目录中的 index.html 就是最终的结果页面，但直接通过浏览器打开这个文件是看不到实际报告内容的，这是因为实际报告内容需要 allure 进行渲染后才能看到

2. Allure 常用特性

场景：

希望在报告中看到测试功能，子功能或场景，测试步骤，包括测试附加信息。

解决：

import allure
@allure.feature('功能名称')
@allure.story('子功能名称')
@allure.title('测试用例名称')
@allure.step('步骤细节')
@allure.description('测试用例描述')
@allure.attach('具体文本信息')：需要附加的信息，可以是数据，文本，图片，视频，网页
如果只测试登录功能运行的时候可以加限制过滤，如：pytest 文件名 --allure_features '购物车功能' --allure_stories '加入购物车'

@alllure.feature() 与 @allure.store() 的关系

feature 相当于一个大的功能或模块。将 case 分类到某个 feature 中，并在报告中的 behaviors 中显示，相当于 testsuite。

story 相当于分支功能/模块，属于 feature 之下的结构，并在报告中的 features 中显示，相当于 testcase。

feature 与 story 类似于父子关系。

@allure.step() 与 with allure.step() 的区别

测试过程中每个步骤，一般放在具体逻辑方法中。
可以放在关键步骤中，在报告中显示。
在 App、Web 自动化测试当中，建议每切换到一个新的页面当做一个 step。
用法：

@allure.step()：只能以装饰器的形式放在类或者方法上。
with allure.step()：可以放在测试用例方法里面，但测试步骤的代码需要被该语句包含。

给测试用例划分优先级

场景：

通常测试有冒烟测试、回归测试、线上验证测试等，那么就需要按照重要性级别来分别执行，比如上线时要把主流程和重要模块都跑一遍。

解决：

通过附加 pytest.mark 标记描述
通过 allure.feature、allure.story 标记描述
通过 allure.severity 直接标记用例级别

根据测试用例的重要性划分测试用例等级，如果没指定等级，默认为 NORMAL 级别：

BLOCKER：阻塞缺陷（功能未实现，无法下一步）
CRITICAL：严重缺陷（功能点缺失）
NORMAL：一般缺陷（边界情况，格式错误）
MINOR：次要缺陷（界面错误与ui需求不符）
TRIVIAL：轻微缺陷（必须项无提示，或者提示不规范）

步骤：

在方法、函数和类上面加：@allure.severity(allure.severity_level.TRIVIAL)
指定执行对应级别的用例：pytest -s -v 文件名 --allure-severities normal, critical

给 Allure 测试报告添加内容（图片、附件、文本、截图、HTML 等）

场景：

前端自动化测试经常需要附加图片或 html，比如在适当的地方、适当的时机截图等。

解决：

@allure.attach() 显示许多不同类型的提供的附件，可以补充测试、步骤或测试结果。

步骤：

在测试报告里附加网页：

格式：allure.attach(body(内容), name, attachment_typeextension)
示例：allure.attach('<head>/head><body>首页</body>', '这是错误页的结果信息', allure.attachment_type.HTML)

在测试报告里附加图片：

格式：allure.attach.file(source, name, attachment_type, extension)
示例：allure.attach.file("./result/b.png", attachment_type=allure.attachment_type.PNG)

集成测试管理系统

@allure.link()、@allure.issue()、@allure.testcase() 主要是为了将 Allure 报告和测试管理系统集成，可以更快速地跳转到公司内部地址。

先看看三个装饰器的源码：

def link(url, link_type=LinkType.LINK, name=None):return safely(plugin_manager.hook.decorate_as_link(url=url, link_type=link_type, name=name))def issue(url, name=None):return link(url, link_type=LinkType.ISSUE, name=name)def testcase(url, name=None):return link(url, link_type=LinkType.TEST_CASE, name=name)

小结

issue() 和 testcase() 其实调用的也是 link()，只是 link_type 不一样。
必传参数 url：跳转的链接。
可选参数 name：显示在 Allure 报告的名字，如果不传就是显示完整的链接（建议传，不然可读性不高）。
可以理解成：三个方法是一样的，我们都提供跳转链接和名字，只是链接的 type 不一样，最终显示出来的样式不一样而已（type 不一样，样式不一样）。
如果你喜欢，只用 @allure.link() 也可以。
而出现三个装饰器的原因是为了更好地将链接进行分类（访问链接、Bug 链接、测试用例链接）。

代码示例

 
import allureTEST_CASE_LINK = 'https://github.com/qameta/allure-integrations/issues/8#issuecomment-268313637'@allure.link('https://www.youtube.com/watch?v=4YYzUTYZRMU')
def test_with_link():pass@allure.link('https://www.youtube.com/watch?v=Su5p2TqZxKU', name='点击我看一看youtube吧')
def test_with_named_link():pass@allure.issue('140', 'bug issue链接')
def test_with_issue_link():pass@allure.testcase(TEST_CASE_LINK, '测试用例地址')
def test_with_testcase_link():pass

运行结果，查看 Allure 报告

3. 接口自动化测试框架示例

完整工程：https://github.com/juno3550/InterfaceAutoTestWithPytest

测试方法示例

 1 import pytest2 import allure3 import logging4 from util.assert_util import assert_keyword5 from util.request_util import api_request6 from util.global_var import *7 from util.excel_util import excel_util8 9 
10 register_test_data = excel_util.get_sheet_data("注册")
11 login_test_data = excel_util.get_sheet_data("登录")
12 
13 
14 @allure.feature("登录模块")
15 @pytest.mark.dependency(name="TestLoginModule")
16 class TestLoginModule:
17         
18     @allure.story("注册功能")
19     @allure.title('用户注册')  # 指定测试用例标题，默认是函数名
20     @allure.description('通过接口进行用户注册')  # 添加测试用例描述
21     @allure.severity(allure.severity_level.BLOCKER)  # 阻塞级别
22     @pytest.mark.run(order=1)
23     @pytest.mark.parametrize('case_data', register_test_data)
24     def test_register(self, case_data):
25         with allure.step("读取请求数据，调用接口"):
26             logging.info("接口用例数据：%s" % case_data)
27             response = api_request(case_data[API_IP], case_data[API_URI], case_data[REQUEST_METHOD],
28                                    case_data[API_REQUEST_DATA], case_data[RESPONSE_EXTRACT_VAR],
29                                    case_data[REQUEST_HEADER], case_data[REQUEST_COOKIE])
30         with allure.step("获取响应数据，进行断言"):
31             assert_keyword(response, case_data[RESPONSE_ASSERT_KEYWORD])
32 
33     @allure.story("登录功能")
34     @allure.title('用户登录')  # 指定测试用例标题，默认是函数名
35     @allure.description('通过接口进行用户登录')  # 添加测试用例描述
36     @allure.severity(allure.severity_level.BLOCKER)  # 阻塞级别
37     @pytest.mark.run(order=2)
38     @pytest.mark.parametrize('case_data', login_test_data)
39     def test_login(self, case_data):
40         with allure.step("读取请求数据，调用接口"):
41             logging.info("接口用例数据：%s" % case_data)
42             response = api_request(case_data[API_IP], case_data[API_URI], case_data[REQUEST_METHOD],
43                                    case_data[API_REQUEST_DATA], case_data[RESPONSE_EXTRACT_VAR],
44                                    case_data[REQUEST_HEADER], case_data[REQUEST_COOKIE])
45         with allure.step("获取响应数据，进行断言"):
46             assert_keyword(response, case_data[RESPONSE_ASSERT_KEYWORD])
47 
48 
49 if __name__ == "__main__":
50     test_dir = os.path.dirname(__file__)
51     pytest.main(['-s', '-q', test_dir, '--alluredir', '../test_result/', "--clean-alluredir"])
52     os.system('allure generate ../test_result/ -o ../test_report/ --clean')
53     os.system('allure open -h 127.0.0.1 -p 8881 ../test_report/')

测试数据示例

Allure 报告结果示例

同时，在这我也准备了一份软件测试视频教程（含接口、自动化、性能等），需要的可以直接在下方观看就行，希望对你有所帮助。

【2024最新版】Python自动化测试15天从入门到精通，10个项目实战，允许白嫖。。。

接口自动化测试框架实战（Pytest+Allure+Excel）

🍅 视频学习：文末有免费的配套视频可观看 🍅 点击文末小卡片，免费获取软件测试全套资料，资料在手，涨薪更快 1. Allure 简介 Allure 框架是一个灵活的、轻量级的、支持多语言的测试报告工具，它不…...

编程日记 2024/6/28 9:51:54

如何预防和处理他人盗用IP地址？

IP地址的定义及作用解释 IP 地址在互联网中的作用。它是唯一标识网络设备的数字地址，类似于物理世界中的邮政地址。 1、IP地址盗窃的定义解释一下什么是IP地址盗用，即非法使用他人的IP地址或者伪造IP地址的行为，这种行为可能引发法律和安…...

编程日记 2024/6/28 9:50:53

【ai】李沐动手深度学学v2 环境安装：anaconda3、pycharm、d2

cuda-toolkit cuda_12.5.0_windows_network.exe 官方课程网站第二版资源下载release版本 pycharm版本李沐【动手学深度学习v2 PyTorch版】课程笔记 CUDA 选择11，实际下载 12.5.0...

编程日记 2024/6/28 9:49:51

前后端分离对软件行业及架构设计的影响

在软件开发领域，前后端分离是一种越来越流行的架构设计模式。这种方法将用户界面（前端）与服务器逻辑（后端）分离开来，允许它们独立开发、测试和部署。本文将探讨前后端分离对软件行业和架构设计的影响&#…...

编程日记 2024/6/28 9:48:49

深入解析Dubbo架构层次

什么是Dubbo？ Dubbo是阿里巴巴开源的一款高性能优秀的服务框架，致力于提供高性能和透明化的 RPC 远程服务调用方案，以及 SOA 服务治理方案。它的主要功能包括： 远程通信：提供高效的远程通信能力。负载均衡&#xff1…...

编程日记 2024/6/28 9:47:48

关于GPIO的上拉、下拉，无上下拉

1.GPIO_PULLUP（上拉） 作用和原理作用：上拉模式会在GPIO引脚和电源电压（Vcc）之间连接一个内部上拉电阻。原理：当引脚配置为输入模式时，如果引脚没有连接到其他外部电路，内部上拉电…...

编程日记 2024/6/28 9:45:46

Python 语法基础二

7.常用内置函数执行这个命令可以查看所有内置函数和内置对象（两个下划线） >>>dir(__builtins__) [__class__, __contains__, __delattr__, __delitem__, __dir__, __doc__, __eq__, __format__, __ge__, __getattribute__, __getitem__, __gt…...

编程日记 2024/6/28 9:44:45

HTML5与HTML：不仅仅是标签的革新

当我们提到HTML5，很多人会想到这是HTML的一个升级版本，增加了许多新的标签和特性。然而，HTML5带来的变化远不止于此。它是一个全面的网页开发框架，重新定义了网络应用程序的构建方式，为开发者提供了前所未有的灵活性和…...

编程日记 2024/6/28 9:43:43

Mybatis面试学习

1.介绍一下mybatis mybatis是一个半自动的ORM的框架，ORM就是对象关系映射。（对象指的是Java对象，关系指的是数据库中的关系模型，对象关系映射，指的就是在Java对象和数据库的关系模型之间建立一种对应关系）…...

编程日记 2024/6/28 9:41:41

el-date-picker设置时间范围

下面这种写法会报错：找不到expirationDate，这是因为涉及到this的指向问题在普通函数中，this 的上下文并不指向 Vue 组件实例，而是取决于函数的调用方式或者是否使用了严格模式 <el-date-pickerclass"date-icon-common&q…...

编程日记 2024/6/28 9:40:40

Links: Challenging Puzzle Game Template（益智游戏模板）

链接：挑战益智游戏《Links》是一款独特且具有挑战性的益智游戏，即将发布。每个级别都会向玩家展示不同的棋盘。目标是通过移动和旋转所有棋子来连接它们。每个棋子都有自己的特点和功能-你可以移动它们，旋转它们，或者两者兼而有之。连接所有棋子，以解决难度和挑战不断增…...

编程日记 2024/6/28 9:38:38

java基于ssm+jsp 仓库智能仓储系统

1管理员功能模块管理员登录，通过填写用户名、密码等信息，输入完成后选择登录即可进入智能仓储系统 ，如图1所示。图1管理员登录界面图智能仓储系统 ，在智能仓储系统可以查看个人中心、公告信息管理、员工管理、供应商管理、商…...

编程日记 2024/6/28 9:36:36

第24篇滑动开关控制LED＜二＞

Q：如何使用Intel FPGA Monitor Program创建滑动开关控制LED工程并运行呢？ A：创建工程的基本过程与前面的Intel FPGA Monitor Program的使用<三>一样，不同的地方是，本实验工程用到了开发板的外设硬件LED和SW&…...

编程日记 2024/6/28 9:35:35

Redis单例部署

目录 1. 概述2. 参考3. 环境4. 部署4.1 操作系统4.1.1 修改系统参数4.1.2 关闭透明大页内存4.1.3 修改系统限制 4.2 安装Redis4.2.1 下载Redis4.2.2 创建redis账号4.2.3 添加Redis环境变量4.2.4 创建Redis使用目录4.2.5 安装Redis4.2.6 手动修改配置文件（**可跳过&a…...

编程日记 2024/6/28 9:33:32

HarmonyOS4升级到Harmonyos Next（Api 11）学习捷径

HarmonyOS4升级到Harmonyos Next（Api 11）学习捷径，新技术学习路上少走弯路。HarmonyOS NEXT和HarmonyOS 4的基本语法都是一样的，但是还有一些区别。如果你学会HarmonyOS4，那么HarmonyOS Next也自然而然的会了。 Harmon…...

编程日记 2024/6/28 9:30:27

[电子电路学]电路分析基本概念1

第一章电路分析的基本概念和基本定律电路模型反映实际电路部件的主要电磁性质的理想电路元件及其组合，是实际电路电气特性的抽象和近似。理想电路元件实际电路器件品种繁多，其电磁特性多元而复杂，分析和计算时非常困难。而理想电路元件…...

编程日记 2024/6/28 9:29:26

Linux bash: /usr/local/gcc/bin/gcc: 不是目录

ln -s /usr/local/bin/gcc /usr/bin/gcc ln -s /usr/local/bin/g /usr/bin/g 创建的软连接不生效问题： [rootdev003 local]# gcc -v bash: /usr/local/gcc/bin/gcc: 不是目录或者 [rootdev003 local]# gcc -v bash: /usr/local/bin/gcc: 没有那个文件或目录解决&…...

编程日记 2024/6/28 9:28:24

vue项目中,pnpm不能用-解决

方法四：解决 PowerShell 执行策略问题如果你决定继续使用 PowerShell，并且遇到执行策略问题，可以尝试以下方法解决： 永久更改执行策略： 在管理员权限的 PowerShell 中运行以下命令，以永久更改执行策略&am…...

编程日记 2024/6/28 9:27:23

数据处理python

1.列筛选 （1）某一列&某几列对于一个表单里面的数据，如果我们想要对于这个表单里面的数据进行处理，我们可以一列一列进行处理，也可以多列一起进行处理； 一列一列处理： 只需要在这个dataf…...

编程日记 2024/6/28 9:25:21

【MotionCap】SLAHMR 在 Colab 的demo运行笔记

【MotionCap】SLAHMR slahmr将人类和相机运动与野外视频分离 CVPR 2023跳至主要内容 SLAHMR (supports 4D Humans).ipynb SLAHMR (supports 4D Humans).ipynb_笔记本已移除星标Google Colab demo for: SLAHMR - Simultaneous Localization And Human Mesh Recovery @inproc…...

编程日记 2024/6/28 9:24:20

Qt-Advanced-Docking-System示例程序

写了一些简单的示例程序，帮助我更好地使用和了解Qt-Advanced-Docking-System 1.写一个如图页面布局的程序 m_pDockMangernew ads::CDockManager(this);this->setCentralWidget(m_pDockManger);ads::CDockWidget* centerDockWidgetnew ads::CDockWidget("中…...

编程日记 2024/6/28 9:23:18

戴尔笔记本重装系统？笔记本卡顿失灵？一键重装系统！

随着科技的快速发展，笔记本电脑已成为我们日常生活和工作中不可或缺的工具。然而，随着时间的推移，笔记本可能会遇到各种问题，如系统卡顿、失灵等。这时，重装系统往往是一个有效的解决方案。本文将详细介绍如何在戴尔笔…...

编程日记 2024/6/28 9:22:17

ViewController 的常用跳转及返回方法

ViewController 的常用跳转及返回方法 ViewController 的常用跳转及返回方法模态跳转导航控制器选项卡控制器Storyboard 的 segues 方式跳转 ViewController 的常用跳转及返回方法模态跳转一个普通的视图控制器一般只有模态跳转的功能，这个方法是所有视图控制器…...

编程日记 2024/6/28 9:21:16

FFmpeg开发笔记（四十一）结合OBS与MediaMTX实现SRT直播推流

《FFmpeg开发实战：从零基础到短视频上线》一书的“10.2 FFmpeg推流和拉流”提到直播行业存在RTSP和RTMP两种常见的流媒体协议。除此以外，还有于2017年推出的SRT协议，相比常见的RTMP协议，SRT协议具有更低的延迟，并且消…...

编程日记 2024/6/28 9:20:15

探索AI的巅峰：详解GPT-3.5与GPT-4系列模型的区别

人工智能领域不断涌现出令人惊叹的技术突破，其中OpenAI的ChatGPT系列模型尤为引人注目。随着GPT-4的发布，技术开发者们对比分析其与前一代GPT-3.5的差异显得尤为重要。本文将深入探讨GPT-3.5和GPT-4系列模型的主要区别，帮助大家更好地理解和应…...

编程日记 2024/6/28 9:19:13

Linux-笔记使用SCP命令传输文件报错：IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!

前言使用scp命令向开发板传输文件发生报错，报错见下图; 解决 rm -rf /home/<用户名>/.ssh/known_hosts 此方法同样适用于使用ssh命令连接开发板报错的情况。参考 https://blog.csdn.net/westsource/article/details/6636096...

编程日记 2024/6/28 9:18:12

计算机网络静态路由及动态路由RIP

一、理论知识 1.静态路由静态路由是由网络管理员手动配置在路由器上的固定路由路径。其优点是简单和对网络拓扑变化不敏感，缺点是维护复杂、易出错，且无法自动适应网络变化。 2.动态路由协议RIP RIP是一种基于距离向量的动态路由协议。它使用跳数作…...

编程日记 2024/6/28 9:16:09

Django实现部门管理功能

在这篇文章中，我们将介绍如何使用Django框架实现一个简单的部门管理功能。这个功能包括部门列表展示、添加新部门、编辑和删除部门等操作。 1. 项目设置首先，确保你已经安装了Django并创建了一个新的Django项目。在项目中，我们需要创建一个名为app01的应用。 2.…...

编程日记 2024/6/28 9:14:07

概率论与数理统计期末复习

概率论常考知识点汇总总括 1. 基础概率论概率定义：理解概率是事件发生的可能性度量，范围从0（不可能）到1（必然发生）。概率公理：掌握概率的三大公理，即非负性、规范性和可加性。条…...

编程日记 2024/6/28 9:13:06

python 识别图片点击，设置坐标，离设置坐标越近的优先识别点击

import pyautogui import cv2 import numpy as np import mathdef find_and_click(template_path, target_x, target_y, match_threshold0.8):"""在屏幕上查找目标图片并点击。Args:template_path: 目标图片的路径。target_x: 预设的坐标 x 轴值。target_y: 预设…...

编程日记 2024/6/28 9:12:05

wordpress 高亮代码/seo指的是什么意思

引言互联网时代，信息传输的基础媒介是比特流，即承载着各种有效信息的01串。换句话说，我们在手机上或者电脑上看到的各类媒体信息，例如文字信息、图片信息亦或是视频信息，其根源上都是一些由二进制的0和1组成的比特流。…...

编程日记 2025/1/16 4:51:58

wordpress怎么汉化插件/河南做网站的公司

In this second part of the series on administration, you will learn how to lock down the site to keep the public from accessing the administration features.在介绍管理部分系列的第二部分，你将学习如何限制访问权限的相关内容。上一节加了三个admin链接&…...

编程日记 2025/1/16 2:08:45

天津市建设银行租房网站/东莞关键词seo优化

〖Array王锐大神力作〗osg与PhysX结合系列内容——地形碰撞体“烘焙”物理碰撞体HeightField与TriangleMesh物理材质的概念与使用直接读取高度图数据与osg::HeightField结合使用Pvd调试环境构建测试场景并运行“烘焙”物理碰撞体在上一篇文章中，我们介绍了多种不同…...

编程日记 2025/1/15 23:40:30

怎么样自己做企业网站/2020国内十大小说网站排名

Item M15：了解异常处理的系统开销转载请注明出处<http://blog.csdn.net/qianqin_2014/article/details/51329961>为了在运行时处理异常，程序要记录大量的信息:无论执行到什么地方，程序都必须能够识别出如果在此处抛出异常的话&#xf…...

编程日记 2025/1/15 23:37:26

个人工商注册查询网站/net的网站建设

SQL SERVER中变量的定义、赋值与使用本文面向对SQL SERVER中变量操作不熟悉的用户，希望能使他们在看完本文后能对变量操作有具体和全面的认识。在学习SQL SERVER的过程中，很多时候需要对某些单独的值进行调试，这时就需要在SQL SERVER中对变…...

编程日记 2025/1/15 22:06:01

可信网站标准版/seo网站推广多少钱

****一、磁盘原理****设备又名I/O设备，泛指计算机系统中除主机以外的所有外部设备。1.1 计算机分类1.1.1 按照信息传输速度分：1.低速设备：每秒传输信息仅几个字节或者百个字节，如：键盘、鼠标等2.中速设备：每…...

编程日记 2025/1/15 21:00:42

1. Allure 简介

2. Allure 常用特性

3. 接口自动化测试框架示例

相关文章：