pytest+allure(allure-pytest基于这个插件)设计定制化报告

一：环境准备

 

• 1.python3.6
• 2.windows环境
• 3.pycharm
• 4.allure-pytest
• 5.allure2.8.0
• 6.java1.8

 

allure-pytest快速安装

在cmd中输入 pip install allure-pytest，回车

二：报告生成

第1步：下载allure.zip，下载地址：allure-github: https://github.com/allure-framework/allure2 ，找到对应版本，并下载

第2步：解压allure.zip，将路径添加环境变量，path中，记得需要重启电脑

第3步：验证allure,在cmd中输入allure,然后回车，如果可以看到一下，说明配置完成

 

第4步：运行测试用例 pytest.main(["-m","login","-s","-q","--alluredir=./report"])

"-m": 标记用例

"login": 被标记需要执行用例

"-s":允许终端在测试运行时输出某些结果，例如你想输入print的内容，可以加上-s

"-q"简化输出结果

"--alluredir": 生成allure指定语法

"./report":生成报告的路径

"--clean-alluredir" ：因为这个插件库allure-pytest生成的报告文件，你第二次运行时候不会清理掉里面的东西，所以你需要删除这个report文件夹，然后运行重新新建reoprt文件夹

说明：运行后，会在report文件夹里面生成文件

三.allure定制化报告

第1步：一些词语解释

一、feature: 标注主要功能模块。
二、story: 标注Features功能模块下的分支功能。
三、severity: 标注测试用例的重要级别。

1）blocker级别：中断缺陷（客户端程序无响应，无法执行下一步操作）
2）critical级别：临界缺陷（功能点缺失）
3）normal级别：正常    默认为这个级别
4）minor级别：次要缺陷（界面错误与UI需求不符）
5）trivial级别：轻微缺陷（必输项无提示，或者提示不规范） 

四、step: 标注测试用例的重要步骤。

五、attach：用于向测试报告中输入一些附加的信息，通常是一些测试数据信息。

1）name就是附件名称，body就是数据，attachment_type就是传类型

2）附件支持的类型（TEXT，HTML，XML，PNG，JPG，JSON，OTHER）

六、issue：这里传的是一个连接，记录的是你的问题。

七、testcase：这里传的是一个连接，记录的是你的用例。

八、description：描述用例信息

第2步：代码展示+报表展示

feature方法的演示

代码：

import pytest,allure
@allure.feature("测试")      #标记代码
class Test_Demo():

    # @allure.story("test_demo_1")
    # @allure.severity("trivial")
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert 1 == 1

报告展示：

story方法的演示

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    @allure.story("test_demo_1")      #标记代码
    # @allure.severity("trivial")
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert 1 == 1
    @allure.story("test_demo_4")       标记代码
    #@allure.severity("minor")
    def test_demo_4(self):
        assert 3 == 3

报告展示：

severity方法的演示：

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    #@allure.story("test_demo_1")
    @allure.severity("trivial")           #标记代码
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert 1 == 1
    #@allure.story("test_demo_4")
    @allure.severity("minor")              #标记代码
    def test_demo_4(self):
        assert 3 == 3

报告展示：

setp方法的演示：

1.总的步骤备注

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    #@allure.story("test_demo_1")
    #@allure.severity("trivial")
    @allure.step("这是两个负数的比较")      #标记代码
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert -1 == -1
    #@allure.story("test_demo_4")
    #@allure.severity("minor")
    @allure.step("这是两个整数的比较")      #标记代码
    def test_demo_4(self):
        assert 3 == 3

报告展示：

2.分步骤备注

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    #@allure.story("test_demo_1")
    #@allure.severity("trivial")
    #@allure.step("这是两个负数的比较")
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert -1 == -1
    #@allure.story("test_demo_4")
    #@allure.severity("minor")
    #@allure.step("这是两个整数的比较")
    def test_demo_4(self):
        with allure.step("赋值一个变量a"):     #标记代码
            a=1
        with allure.step("赋值一个变量b"):     #标记代码
            b=1
        assert a == b

报表展示：

attach方法的演示：

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    #@allure.story("test_demo_1")
    #@allure.severity("trivial")
    #@allure.step("这是两个负数的比较")
    def test_demo_1(self):
        # """
        # 用例描述：22222222222222
        # """
        #allure.MASTER_HELPER.description("11111111111111")
        assert -1 == -1
    #@allure.story("test_demo_4")
    #@allure.severity("minor")
    #@allure.step("这是两个整数的比较")
    def test_demo_4(self):
        a = 1
        allure.attach("{0}".format(a),"预期结果")    #标记代码    第一个参数是body，第二个参数是name
        b=1
        allure.attach("{0}".format(b),"实际结果")　　#标记代码
        assert a == b

报告展示：

图片附件形式：

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    @allure.story("test_demo_1")
    @allure.severity("trivial")
    def test_demo_1(self):
        assert 1 == 1

    def test_demo_3(self):
        """
            用例描述：这里是两个数字是否相等
        """
        a = 3
        b = 3
        with open(r"G:Web_automationLearn_pytest	est_casesimg2.jpg","rb") as file:          #标记代码，需要先打开图片
            file=file.read()　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 #标记代码，读取图片
            allure.attach(file,"预期结果",attachment_type=allure.attachment_type.JPG)　　　　　　　　#标记代码
        assert a == b

报告展示：

issue和testcase方法的演示：

代码：

import pytest,allure
@allure.feature("测试")
class Test_Demo():

    @allure.story("test_demo_1")
    @allure.testcase("https://home.cnblogs.com/")
    def test_demo_1(self):
        assert 1 == 1

    @allure.testcase("https://home.cnblogs.com/","测试用例地址请点击跳转")     #标记代码，你可以指定连接的名字，报告里面就会现在这个名字的连接
    @allure.issue("http://www.baidu.com")　　　　　　　　　　　　　　　　　　　　　#标记代码，哪个写在后，在报告里面就会显示在前面
    def test_demo_4(self):
         assert 3 == 3

报表展示：

description方法的演示：

代码：（这两种备注方式不能同时是存在，如果同时存在他会先使用description的，而不取3引号的）

import pytest,allure
@allure.feature("测试")
class Test_Demo():


    @allure.story("test_demo_1")
    @allure.testcase("https://home.cnblogs.com/")
    def test_demo_1(self):
        assert 1 == 1

    @allure.description("这里是两个3的比较")             #标记代码，优先取这个
    def test_demo_4(self):
        """
            用例描述：这里是两个数字是否相等　　　　　　　　　#如果没有description，那么就取3引号的
        """
        assert 3 == 3

报告演示：

四.报告显示

报告显示方法一：

第1步：以上运行之后，可以在CMD中运行命令

allure generate report -o html --clean

report是alluredir生成的xml目录，html是最终生成html的目录

第2步：运行命令后，可以在html路径下看到生成的数据，其中index.html就是我们要的allure报告，你可以在pycharm里面打开，报告展示如下

 

报告显示方法二(这种相当于是调试)：

第1步：以上运行之后，可以在CMD中运行命令

allure serve report   (report是alluredir生成的xml目录)

运行后，浏览器会自动跳转到allure report界面

 

四.pytest+allure+jenkins集成

参考我另外的一个博客文章：https://www.cnblogs.com/hao2018/p/11135180.html

注意：在本地运行的时候需要手动把代码拷贝到jenkins目录下面的workspace文件夹里面；如果在git或svn上运行，jekins会直接把代码拷贝到workspace目录 ,如果jenkins是指定工作目录就不用管了