07-02 测试报告-allure 测试测试工具

简介
allure

轻量级、灵活的、支持多语言的测试报告工具
多平台的、奢华的报告框架
可以为开发、测试提供详尽的测试报告、测试步骤、日志
为管理层提供高规格的统计报告
使用 Java 开发，支持pytest、JavaScript、PHP、Ruby等
可以集成到Jenkins

官网：
allure官网
官方使用文档：
allure 使用文档

文章图片

安装
Windows / Mac / Linux 通用安装方法：
下载 allure.zip 安装包，解压后配置环境变量即可：
配置路径：allure-2.13.8\bin
allure 官方安装包下载：
allure安装包下载
百度网盘下载：
allure-百度网盘
Mac 命令行安装：
brew install allure
结合 pytest 使用，需要安装 python 插件：
pip install allure-pytest
运行

在测试执行期间收集结果：

pytes [测试文件] -s -q --alluredir ./result/# --alluredir 这个选项用于指定存储测试结果的路径

查看测试报告：
- 测试完成后查看实际报告，在线查看报告，会直接打开默认浏览器展示当前报告：

allure serve ./result/

从结果生成报告，这是一个启动 tomcat 的服务，包括两步：
- 生成报告：

allure generate ./result/ -o ./report/ --clean # 覆盖路径需要添加 --clean

打开报告（可远程打开）

allure open -h host -p port ./report/

常用特性
使用场景：在报告中看到测试功能，子功能或场景、测试步骤，包括测试附加信息
使用方法：使用装饰器

@allure.feature("功能名称")

@allure.feature("测试采购合同模块")# 通常对测试类进行装饰 class TestPurchaseContract:

@allure.story("子功能/单个用例名称")

@allure.story("测试同步标识灯功能")# 通常对单个用例进行装饰 def test_synchronize(self): """ 测试同步标识灯功能 :return: """ r = self.pending_request.synchronize() assert r["msg"] == "同步更新申购单红、绿、蓝灯状态成功" assert r["success"] is True

@allure.step("步骤细节")

with allure.step("步骤细节"): # 具体测试步骤代码

@allure.attach("附加信息/日志--可以是数据、文本、图片等")

只运行指定 feature 的用例：

pytest test.py --allure-features="功能名称"

只运行指定 story 的用例：

pytst test.py --allure-stories="子功能/单个用例名称"

结合使用：

pytest test.py --allure-features="功能名称" --allure-stories="子功能/单个用例名称"

allure 特性-testcase
【07-02 测试报告-allure】关联测试用例：直接给测试用例的链接地址

test_case_link = "测试用例链接"@allure.testcase(test_case_link, "描述说明") def test_with_testcase_link(): pass

测试报告本地静态数据生成

allure generate ./result -o ./report --clean # -o：指定报告生成的文件夹 # --clean：先清空测试报告目录，在生成新的测试报告

生成的静态数据，可以使用 tomcat 搭建的web服务中打开
按重要性级别划分测试用例
使用场景：
通常测试有PO、冒烟测试、验证上线测试、回归测试，按重要性级别来分别执行；比如上线要把主流程和重要的模块都跑一遍
用例等级：

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

使用方法：

# 在方法、函数、类上装饰 @allure.severity(allure.severity_level.TRIVIAL) def test_with_trivial_severity(): pass@allure.severity(allure.severity_level.NORMAL) def test_with_normal_severity(): pass# 执行 pytest -s -v 文件名 --allure-severities normal, critical pytest -s -v 文件名 --allure-severities=normal, critical

UI自动化测试-截图
使用场景： UI自动化测试经常需要附加图片 / html，在适当的位置进行截图
使用方法：

allure.attach(body, name, attachment_type, extension) # body：要显示的内容（附件） # name：附件名字 # attachment_type：附件类型，是 allure.attachment_type 里面的其中一种 # extension：附件的扩展名（比较少用）allure.attach.file(source, name, attachment_type, extension) # source：文件路径，相当于传一个文件 # attachment_type提供的附件类型