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

pytest框架 - 第二集 allure报告

article 2025/9/20 10:51:39

一、断言assert

二、Pytest 结合 allure-pytest 插件生成美观的 Allure 报告

(1) 安装 allure 环境

安装 allure-pytest 插件：pip install allure-pytest
在 github 下载 allure 报告文件
- 地址：Releases · allure-framework/allure2 · GitHub
- 下载：allure-2.21.0.zip
- 配置 path 环境变量（不能有中文）：D:\allure-2.21.0\bin
重启 Pycharm 并验证是否安装成功
在 dos 和 pycharm 中输入：allure --version 能看到版本号说明 OK

(2) 生成 allure 报告

生成临时的 json 报告
addopts = -vs --alluredir=temps --clean-alluredir （ini）

解释：
--alluredir=temps 生成临时的 json 报告
--clean-alluredir 每一次运行清空临时的 json 报告

根据 json 报告生成 html 的 allure 报告

if __name__ == '__main__':pytest.main()time.sleep(3)os.system("allure generate./temps -o./reports --clean")

./temps 临时 json 报告文件夹
-o output 输出
./reports allure 报告的路径
--clean 每一次运行清空 allure 报告

上面这个运行起来有问题故优化代码为：

就是把ini的设定放到run里面

(3) 企业级 allure 报告定制

1. 企业 LOGO 定制

更改 D:\allure-2.21.0\config 目录下的 allure.yml 配置文件，加入自定义 logo

yaml

plugins:- junit-xml-plugin- xunit-xml-plugin- trx-plugin- behaviors-plugin- packages-plugin- screen-diff-plugin- xctest-plugin- jira-plugin- xray-plugin- custom-logo-plugin

2. 更改图标

在 D:\allure-2.21.0 - 测试 \plugins\custom-logo-plugin\static 目录下加入 logo 图片

3. 更改样式

在 D:\allure-2.21.0 - 测试 \plugins\custom-logo-plugin\static 目录下修改 style.css 的样式

css

/*
.side-nav__brand {background: url('logo.png') no-repeat left center!important;margin-left: 10px;
}
*/.side-nav__brand{background: url('logo.png') no-repeat left center!important;margin-left: 22px;height: 90px;background-size: contain!important;
}.side-nav__brand-text{display: none;
}

最后根据margin-left: 22px;和height: 90px;样式调整 logo 大小和位置。

2. 项目结构的报告定制

报告左边的定制

@allure.epic("项目名称：码尚教育金融项目接口自动化报告")
@allure.feature("模块名称：用户管理模块")
class TestApi:@allure.story("接口名称：登陆接口")#@allure.title("验证登陆接口成功返回数据")def test_login(self):print("登陆测试用例")allure.dynamic.title("接口登陆成功")assert "a" in "abc"

报告右边的定制

优先级：BLOCKER（致命），CRITICAL（严重），NORMAL（一般），MINOR（提示），TRIVIAL（轻微）

@allure.epic("项目名称: 金融项目接口自动化报告")
@allure.feature("模块名称: 用户管理模块")
class TestApi:@allure.story("接口名称: 登陆接口")#@allure.title("验证登陆接口成功返回数据")@allure.severity(allure.severity_level.BLOCKER)def test_login(self):print("登陆测试用例")allure.dynamic.title("接口登陆成功")assert "a" in "abc"@allure.story("接口名称: 登陆接口")@allure.title("验证登陆失败")def test_login2(self):print("登陆测试用例")assert "a" in "abc"def test_register(self):print("注册测试用例")

装饰器部分

@allure.epic("项目名称：金融项目接口自动化报告")

allure.epic 装饰器用于定义测试用例所属的史诗级（项目级）别的标题，这里指定了项目名称为 “金融项目接口自动化报告” ，在 Allure 报告中会以项目维度进行展示，方便从宏观层面归类测试用例。

@allure.feature("模块名称：用户管理模块")

allure.feature 装饰器用来标识测试用例所属的功能模块，这里表明这些测试用例属于 “用户管理模块” ，可以将同一功能模块下的测试用例聚合展示在 Allure 报告中。

@allure.story("接口名称：登陆接口")

allure.story 装饰器用于进一步细化测试用例所属的用户故事，这里表示测试用例围绕 “登陆接口” 展开，可帮助在报告中按不同接口维度组织测试用例。

@allure.title("验证登陆失败")

allure.title 装饰器用于指定测试用例在 Allure 报告中显示的标题。在test_login2方法上使用，意味着该测试用例在报告中展示的标题为 “验证登陆失败” ，可使报告中的用例标题更清晰易读。

@allure.severity(allure.severity_level.BLOCKER)

allure.severity 装饰器用于设置测试用例的严重级别，这里设置为allure.severity_level.BLOCKER（致命级别），表示这个测试用例对应的问题如果失败，会严重影响系统功能，导致系统无法正常使用。在 Allure 报告中会根据严重级别对测试用例进行分类展示和统计。

@allure.link(url="http://www.baidu.com",name="接口访问链接") ：在 Allure 报告中添加一个指向指定网址的链接，名称为 “接口访问链接”，方便查看与接口相关的外部资源。
@allure.issue(url="http://www.baidu.com",name="bug链接") ：在报告中添加指向 bug 跟踪系统等的链接，名称为 “bug 链接”，用于关联该测试用例可能存在的问题记录。
@allure.testcase(url="http://www.baidu.com",name="测试用例链接") ：在报告中添加指向测试用例详细文档等的链接，名称为 “测试用例链接”，方便追溯测试用例的设计和详细说明。

allure.attach() 是 Allure 框架提供的一个核心方法，用于在测试报告中添加额外的附件（如截图、日志、请求响应数据等），丰富测试结果的可视化信息。这些附件会显示在测试报告的详情页中，帮助测试人员更直观地定位问题。

核心功能

添加附件到测试报告
可以将各种类型的文件或数据（如图片、文本、JSON、XML 等）作为附件嵌入到 Allure 报告中。
支持多种附件类型
通过 attachment_type 参数指定附件类型，常见类型包括：
- allure.attachment_type.PNG/JPEG：图片
- allure.attachment_type.TEXT：文本
- allure.attachment_type.JSON：JSON 数据
- allure.attachment_type.HTML：HTML 片段
- allure.attachment_type.XML：XML 数据

方法参数

allure.attach(body: Union[str, bytes],         # 附件内容（字符串或字节流）name: str = None,                # 附件名称（显示在报告中）attachment_type: allure.attachment_type = None,  # 附件类型extension: str = None            # 附件扩展名（可选）
)