Allure2 报告中添加用例分类

一. 简介

在测试过程中，为了更好地管理项目及其不同模块下的用例，我们可以利用 Allure 根据模块对用例进行分类，分类后的测试报告就不再是一堆平铺直叙的用例列表，而会变成一个有层级、有结构的专业测试报告。这不仅有助于整理报告结构，还支持只运行特定类别下的用例。

二、Allure 添加用例分类

Allure 报告通过层级化的方式展示用例结构，通常包含 Epic（史诗）、Feature（特性） 和 Story（故事） 三个层级。

epic 与 feature，feature 与 story 类似于父子关系：

@allure.epic：史诗。对应敏捷开发中的概念，通常定义为一个大的项目或需求集。
@allure.feature：特性/功能模块。相当于一个具体的功能模块或测试套件，包含多个子分支。
@allure.story：故事/子功能。对应功能模块下的具体场景或分支功能。

2.1 项目/需求层级分类 - `@allure.epic(name)`装饰器

若要在测试报告中清晰地展示用例所属的项目，应使用 @allure.epic 装饰器。

该装饰器通常应用于测试类，而非单个测试用例，用于定义一个宏观的项目或需求集。由于其覆盖范围较广，我们通常会在 epic 之下，进一步使用粒度更细的 @allure.story 来定义具体的用户故事或业务场景，从而形成清晰的层级结构。

语法：@allure.epic("项目需求描述")

业务场景：安卓端手机基本功能测试

定义项目分类（Android），记录其关联的测试用例

代码示例

python 复制代码

import allure

@allure.epic("Android")
class TestEpic:

    def test_case1(self):
        print("拨打电话")

    def test_case2(self):
        print("发送短信")

    def test_case3(self):
        print("接听电话")

    def test_case4(self):
        print("链接WiFi")

    def test_case5(self):
        print("开启热点")

效果如下
- 直接显示URL

2.2 功能模块层级分类 - `@allure.feature(name)`装饰器

通过 @allure.feature(name) 可以将项目分类中进行模块基本的分类，使用例管理更清晰。

语法：@allure.feature('功能名称')

业务场景：安卓端手机存在多个模块如：电话、蓝牙、WiFi等

定义模块分类（call、WiFi），记录和管理其模块内部用例

代码示例

python 复制代码

import allure

@allure.epic("Android")
@allure.feature("call")
class TestEpicCall:

    def test_case1(self):
        print("拨打电话")

    def test_case2(self):
        print("发送短信")

    def test_case3(self):
        print("接听电话")

@allure.epic("Android")
@allure.feature("WiFi")
class TestEpicWifi:

    def test_case4(self):
        print("链接WiFi")

    def test_case5(self):
        print("开启热点")

生成报告查看结果

2.3 子功能/场景层级分类 - `@allure.story(name)`装饰器

如果要在报告中看到测试的子功能的描述，可以使用 @allure.story。

语法：@allure.story('子功能名称')
- 相同的子功能名称会被归类为一个子功能层级下

业务场景：安卓端手机存在多个模块如：电话、蓝牙、WiFi等

在模块分类下，按子功能进行进一步分类

代码示例

python 复制代码

import allure
	
@allure.epic("Android")
@allure.feature("call")
class TestEpicCall:

    @allure.story("通讯功能")
    def test_case1(self):
        print("拨打电话")

    @allure.story("通讯功能")
    def test_case3(self):
        print("接听电话")

    @allure.story("发送短信")
    def test_case2(self):
        print("发送短信")

@allure.epic("Android")
@allure.feature("WiFi")
class TestEpicWifi:

    @allure.story("链接WiFi")
    def test_case4(self):
        print("链接WiFi")

    @allure.story("开启热点")
    def test_case5(self):
        print("开启热点")

生成报告查看结果

Allure2 报告中添加用例分类

一. 简介

二、Allure 添加用例分类

2.1 项目/需求层级分类 - @allure.epic(name)装饰器

2.2 功能模块层级分类 - @allure.feature(name)装饰器

2.3 子功能/场景层级分类 - @allure.story(name)装饰器

2.1 项目/需求层级分类 - `@allure.epic(name)`装饰器

2.2 功能模块层级分类 - `@allure.feature(name)`装饰器

2.3 子功能/场景层级分类 - `@allure.story(name)`装饰器