使用allure如何生成自动化测试报告 ？一文详解allure的使用 。

网上介绍allure报告的很多 ，但个人总感觉还是不够整体 ，不够详细 ，所看到的都是局部 。故本人花了些时间 ，将这个allure详细的整理了一遍 。整体且涉及每个细节 。

1.allure介绍

 

• 它是一个生成HTML测试报告的工具包

• 使用java开发，所以需要java环境

• 功能强大 , 生成的报告美观、直观

• 需要用pytest去搜集测试用例

• 使用浏览器打开，更易进行持续集成

2.allure相关安装和配置

2.1 软件安装列表

想使用allure，需要安装如下软件 ：

如果你先上面下载的麻烦 ，这里直接提供已下载好的安装包 ：

2.2 安装四步曲

以上软件安装成功需要四步，分别为 ：

1. 下载 ，上面下已经地址，没有的自行下载即可。

2. 安装 ，

   • allure无需安装，直接解压到一个指定的路径下即可

   • pytest只需要在cmd命令中运行pip install pytest即可 。

   • 其它软件直接双击，一路下一步即可安装成功

3. 配置环境变量，以上除了pytest不需要配置环境变量，其它的都需要配置 ,具体如何配置见2.3

4. 验证 ：除了pycharm无需要验证外，其它的都需要输入命令验证，打开cmd窗口输入以下命令进行验证：

# 1. java验证 ：
java --version
​
# 2. python验证 ：
python -V
​
# 3. allure验证
allure --version
​
# 4. pytest验证
pip show pytest

2.3 环境变量配置

（1）java环境配置

此电脑-鼠标右击-属性-高级系统设置-环境变量-添加java环境变量，具体如下：

注意 ： 变量值里面的路径一定是你自己电脑上安装java的路径

将以上变量保存后，接下来编辑path环境变量 ，添加%JAVA_HOME%\bin ,一般可以将其移到最上面，点击确定。

（2）python环境配置

此电脑-鼠标右击-属性-高级系统设置-环境变量-点击path变量进行编辑(以存在，故是编辑)，添加：

注意 ：这里的python路径一定是你电脑上的路径

（3）allure环境配置

此电脑-鼠标右击-属性-高级系统设置-环境变量-添加allure环境变量，具体如下：

3.allure功能

3.1 allure整体流程

 

其实 ，在allure中主要分为以上的三部分，分别是用于集成在测试用例的装饰器函数 、 通过命令行命令收集测试用例的命令行工具、最后就是生成测试报告的展示 。

具体使用时，按照如下的流程实现即可 ：

1. 在编写好的测试用例中添加allure装饰器函数 ，

2. 在运行入口处编写运行allure执行命令 ，它就会生成测试报告

3. 通过浏览器查看生成的测试报告 。

3.2 allure装饰器函数

（1）基本说明

allure装饰器

# 作用：用于将测试用例的数据展示到测试报告中
# 导入：import allure
# 说明 ： 
    1.需要将这些装饰器函数添加测试方法或测试类的开头。
    2.同一个类或者一个方法可以添加多个装饰器函数 ，这样此用例就具有了个作用属性 。    

（2）装饰器函数
 

以上的装饰器其实就是对应测试用例模板中的一些字段 ，具体如下 ：

(3)如何在脚本中使用  

（4）使用总结

将我们以上的装饰器整理后就是如下的结构 ，按照此结构可以整理出你的测试用例 。

如果你编写的测试用例装饰器函数都已经使用 ，那么它的层级就是如上的结构 ，当然这里还需要说明以下几点 ：

1. 每一个装饰器都是可选项，可加可不加 。比如你把feature去掉了，那么在报告中就不展示这一层级了 ，其它也是如此。

2. epic、feature、story、title主要用来显示层级 ，而到了title层里，就是显示具体的内容 ，内容包括severity,description,testcase ,issue,link,step等

3. 除了step和attachment比较特殊以外，它们都是放在方法内使用 ，其它的都是标注在测试方法的开头或者类的开头 。

那么，在项目中该怎么组织我们的测试用例呢 ？一般就是按照项目结构一层一层的组织下来 ，比如 ：

 

@allure.epic("vshop")					#标记属于那个项目
@allure.feature("订单")					# 标记属于那个模块
@allure.story("订单列表")					#标记属于那个子模块
@allure.issue("http://localhost")
class TestOrder(unittest.TestCase):
 
    @classmethod
    def setUpClass(cls) -> None:
        cls.reg = RegLogic()
        cls.mysql = BaseMysql()
        cls.mobile = '13712345678'
        cls.password1,cls.password2 = 123456,123456
 
    def setUp(self) -> None:
        self.driver = webdriver.Chrome()
        self.driver.maximize_window()
        self.driver.get("http://localhost")
 
        # 判断账号是否存在
        result = self.mysql.get_one(get_user.format(self.mobile))
        logger.info("查找注册账号结果:{}".format(result))
        if result:
            self.mysql.exec_sql(del_user.format(self.mobile))
 
    def tearDown(self) -> None:
        self.mysql.exec_sql(del_user.format(self.mobile))
        self.mysql.close()
        self.driver.quit()
 
 
    @allure.title("查询订单列表")						#标记测试用例
    @allure.description("显示该列表的所有数据")			# 标记用例的描述
    def test_order_list(self):
        with allure.step("1.进入我的订单列表页"):		#标记测试步骤
            self.order(self.driver)
        # 断言
        self.assertEqual("安全退出",self.reg.get_reg_msg(self.driver))
 
    @allure.title("查询订单详情")						#标记测试用例
    @allure.description("显示该订单的数据详情")			# 标记用例的描述
    def test_order_list(self):	
        with allure.step("1.进入我的订单列表页"):
            self.order(self.driver)
        with allure.step("2.点击最上面一个订单"):
            self.order_detail(self.driver)
        # 断言
        self.assertEqual("安全退出",self.reg.get_reg_msg(self.driver))

3.3命令行参数

（1）命令行参数说明

所谓的命令行参数，就是通过cmd窗口运行的命令 ，如果你对allure的命令行参数不太清楚，可以打开cmd窗口输入：

allure --help

就可以看到如下的显示：

Usage: allure [options] [command] [command options]
  Options:
    --help
      Print commandline help.
    -q, --quiet
      Switch on the quiet mode.
      Default: false
    -v, --verbose
      Switch on the verbose mode.
      Default: false
    --version
      Print commandline version.
      Default: false
  Commands:
    generate      Generate the report
      Usage: generate [options] The directories with allure results
        Options:
          -c, --clean
            Clean Allure report directory before generating a new one.
            Default: false
          --config
            Allure commandline config path. If specified overrides values from
            --profile and --configDirectory.
          --configDirectory
            Allure commandline configurations directory. By default uses
            ALLURE_HOME directory.
          --profile
            Allure commandline configuration profile.
          -o, --report-dir, --output
            The directory to generate Allure report into.
            Default: allure-report
​
    serve      Serve the report
      Usage: serve [options] The directories with allure results
        Options:
          --config
            Allure commandline config path. If specified overrides values from
            --profile and --configDirectory.
          --configDirectory
            Allure commandline configurations directory. By default uses
            ALLURE_HOME directory.
          -h, --host
            This host will be used to start web server for the report.
          -p, --port
            This port will be used to start web server for the report.
            Default: 0
          --profile
            Allure commandline configuration profile.
​
    open      Open generated report
      Usage: open [options] The report directory
        Options:
          -h, --host
            This host will be used to start web server for the report.
          -p, --port
            This port will be used to start web server for the report.
            Default: 0
​
    plugin      Generate the report
      Usage: plugin [options]
        Options:
          --config
            Allure commandline config path. If specified overrides values from
            --profile and --configDirectory.
          --configDirectory
            Allure commandline configurations directory. By default uses
            ALLURE_HOME directory.
          --profile
            Allure commandline configuration profile.

以上就是allure显示的命令行参数 ，你可以先看它的格式 ，具体如下：

allure格式: allure [options] [command] [command options]

其中除了allure是必须输入的，剩下括号内的都是可选项，可输可不输人

第一部分就是options，具体包括如下参数 ：

  Options:
    --help
      Print commandline help.
    -q, --quiet
      Switch on the quiet mode.
      Default: false
    -v, --verbose
      Switch on the verbose mode.
      Default: false
    --version
      Print commandline version.
      Default: false

这个里面都是一些基本信息，相对来说用的少，这里我们不做介绍

第二部分是command，具体包括：

• generate ：Generate the report

• serve ： Serve the report

• open ：Open generated report

• plugin：Generate the report

以上的命令虽然只有四个，但是每个命令下又都有若干个参数 ，一般加上那个命令，就的加上对应的一些参数 ，这里面我们主要介绍常用的generate命令 。

第三部分是command options，这里主要介绍generate选项 ：

Usage: generate [options] The directories with allure results
        Options:
          -c, --clean
            Clean Allure report directory before generating a new one.
            Default: false
          --config
            Allure commandline config path. If specified overrides values from
            --profile and --configDirectory.
          --configDirectory
            Allure commandline configurations directory. By default uses
            ALLURE_HOME directory.
          --profile
            Allure commandline configuration profile.
          -o, --report-dir, --output
            The directory to generate Allure report into.
            Default: allure-report

这里主要使用的两个选项就是 ：

• -c : 每次生成报告前清除之前生成的报告文件 ，不加此选项则默认为不清除 。

• -o : 生成报告的路径 ，也就是你要将测试报告输出到哪里 。

所以 ，我们该如何使用此命令行参数呢 ？可以在cmd窗口运行如下命令：

allure generate JSON路径 -o 生成测试报告路径 -c 

这里有一个JSON路径，这个需要通过pytest生成一堆json文件，存放这堆JSON文件的这个路径就是JSON路径。

不过这个命令一般集成在python中去使用的，具体写法参考项目文件。

3.4 生成测试报告

生成的报告就是如下的情况 ：

（1）整体说明：

每个tab页都是啥意思呢 ？接下来我们来看下面的说明 ：

 （2）总览：

所以，此页面主要是展示和链接其它页面功能 ，相当与其它页面的汇总 。

（3）类别

所谓类别，就是按照不同用例的运行结果划分的一个分类 ，具体包括 ：

• 报错的用例

• 运行失败的用例

• 运行成功的用例

• 跳过的用例

• 未知的用例 。

 

（4）测试套

这里的测试套，并不是测试套件 ，它只是按照你项目测试用例的层级一层一层的组织展示的。比如我的代码层级为：

cases:
    test_login.py
    test_buy_flow.py
    test_reg.py
    
# test_login.py中的代码为:
class TestLogin():
    pass
 
# test_buy_flow.py中的代码为：
class TestBuyFlow():
    pass
 
# test_reg.py中的代码为
class TestReg():
    pass

以上的用例组织结构就变为下图的展示方式了 。

（5）图表

这个就是按照不同的维度进行了数据统计，包括：用例状态、优先级、耗时等。

（6）时间刻度

主要统计各个用例的运行时间 ，比如想知道那些用例运行花费的时间长，看这个数据就可以知道 。

（7）功能

在最开始我们介绍到了allure的装饰器函数 ，分别给每个用例都做了标记 ，那么所标记的结果就是从功能里查看 ，具体如下：

（8）包

此功能忽略中间层级 ，只展示测试方法，即测试用例 ，对于看测试具体结果来说更加直观。

（9）总结

通过上我们可以看到 ，整体来说还是以测试报告的展示为主 ，只不过他的展示维度不同。既然展示维度不同 ，那么查看时更多的结合实际场景来查看，具体可参考如下方式 ：

• （1）要看总体情况 ，先看总览，可以了解到编写了多少测试用例 ，有多少成功的、多少失败的。

• （2）运行结果若出现用例运行失败的，报错的，可以查看类别 ，这里按照类别分类 ，查看时更加直观 ，帮助你更快的分析和定位问题。

• （3）想查看哪些用例运行速度慢 ，可以看时间刻度，它可以帮你找出运行慢的用例 ，从而可以进行针对性的性能优化 。

• （4）快速定位是那个用例运行失败的(要定位到测试方法的) ，可以查看包 ，这个能很直观的看到编写了哪些测试方法，那个成功、那个失败 ，结果一目了然 。

• （5）若想核对你编写的测试用例情况(和测试用例文件核对) ，可以查看功能，因为它是按照项目层级展示，看起来更加直观 。

• （6）若想从代码角度来看编写的测试用例情况，可以查看测试套 ，因为它就是按照代码层级所展示的 。

4.项目实践

在之前介绍的测试用例登录脚本中，我们并没有集成测试报告，接下来重写以下两个文件 ，包括 ：

 （1）登录测试用例 ：test_login.py

import unittest
from api.login_demo_api import login
from utils.basic_utils import read_yaml, get_file_path
import allure
​
@allure.epic("vshop")
@allure.story("登录")
class TestLogin(unittest.TestCase):
​
    @classmethod
    def setUpClass(cls) -> None:
        yaml_path = get_file_path('login.yaml')     # 获取login.yaml的全路径
        result = read_yaml(yaml_path)           # 转化为python对象
        cls.login_data = result.get('login')    # 获取字典中login的值
​
    # case1 : 测试登录成功
    @allure.title("输入正确的用户名和正确的密码进行登录")
    @allure.description("预期结果:登录成功")
    def test_login_success(self):
        res = self.login_data[0]    # 获取列表中第一个值
        login_result = login(res.get('username'),res.get("password"))
        self.assertEqual(res.get("code"), login_result.get('errno'))
        self.assertEqual(res.get("message"), login_result.get('errmsg'))
​
    # case2 : 测试密码错误
    @allure.title("输入正确的用户名和错误的密码进行登录")
    @allure.description("预期结果:用户帐号或密码不正确")
    def test_password_is_wrong(self):
        res = self.login_data[1]    # 获取列表中第二个值
        login_result = login(res.get('username'),res.get("password"))
        self.assertEqual(res.get("code"), login_result.get('errno'))
        self.assertEqual(res.get("message"), login_result.get('errmsg',login_result))
​
    # case3 : 测试密码为空
    @allure.title("输入正确的用户名和空的密码进行登录")
    @allure.description("预期结果:参数不对")
    def test_password_is_null(self):
        res = self.login_data[2]    # 获取列表中第三个值
        login_result = login(res.get('username'),res.get("password"))
        self.assertEqual(res.get("code"), login_result.get('errno'))
        self.assertEqual(res.get("message"), login_result.get('errmsg',login_result))

(2) 运行入口脚本：runner.py

import pytest
import os
​
​
if __name__ == '__main__':
​
    # 1. 使用pytest生成测试报告时需要传递一个列表
    json_dir_path = 'result'
    args_list = ['-s', '-v', 'cases', '--alluredir', json_dir_path]
    pytest.main(args_list)
​
    # 2. 使用allure命令生成测试报告 ：allure generate 数据路径文件 -o html路径文件 -c
    html_dir_path = 'report'
    cmd = 'allure generate {} -o {} -c'.format(json_dir_path, html_dir_path)
    os.system(cmd)

(3) 生成测试结果 ：report文件夹，打开此文件夹，通过浏览器打开index.html文件 ，就会展示具体生成的测试报告 。