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

关联测试用例：直接给测试用例的链接地址

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，在适当的位置进行截图