pytest-测试报告

pytest-html生成测试报告插件

在pytest中，我们使用pytest-html该插件来生成插件。

下载

pip install pytest-html
pip37 install -i https://pypi.doubanio.com/simple pytest-html
python -m pip install -i https://pypi.doubanio.com/simple pytest-html

使用

在配置文件中配置：

[pytest]
addopts = --html=report/report.html

意思是在执行测试用例的时候，需要生成HTML报告。将报告生成到项目根目录下的report文件夹中，报告的名字是report.html

allure生成测试用例报告的框架插件

我们使用pytest框架搭配allure框架，生成一个比pytest-html生成的测试报告，漂亮100倍的测试报告。

下载

pip install -i https://pypi.doubanio.com/simple allure-pytest

使用

在配置文件的addopts参数后，追加

[pytest]
addopts = --alluredir ./report/allure_html

意思，将allure生成的测试报告数据，创建到项目的根目录下的report/allure_html目录中。

注意:

1. allure-pytest模块只能帮我们将测试报告的数据创建出来，但是无法生成HTML格式的测试报告。
2. 生成的数据当再次运行的时候，不会清空，而是以追加的方式

allure插件的安装

前提是，allure插件依赖Java环境。

1. Windows安装allure

   1. 将压缩包解压合到合适目录
   2. 将安装目录中的bin目录添加到系统的环境变量中
   3. 测试：终端执行allure --version，返回版本即可

2. mac安装allure

   1. 将tgz压缩包解压合到合适目录
   2. 将安装目录中的bin目录添加到系统的环境变量中：/etc/profile

   PATH='/usr/local/src/python36/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:C:\Program Files\allure-2.10.0\bin'
   

allure插件读取json/txt文件生成测试报告

allure generate report/result -o report/allure_html --clean

使用

1. 首先将终端的路径切换到项目的根目录下

2. 使用命令生成测试报告

allure generate report/allure_html -o report/allure_report

• report/allure_html 数据来源
• -o report/allure_report 生成测试报告到哪个目录

注意，如果再次运行上述命令，需要加上--clean, --clean就是清空并覆盖报告

allure generate report/allure_html -o report/allure_report --clean

allure工具的问题及解决

如果生成的报告展示时，无数据，就终端执行下面的命令：

allure open report/allure_html

allure工具生成的测试报告在report/allure_html

title和描述

为了allure报告更加美观，我们可以为用例函数和用例方法，添加title和description，提高可读性：

import pytest
import allure


@allure.title("主页用例")
@allure.description("测试主页的用例")
def test_index():
    assert 1

@allure.title("数据库用例")
@allure.description("测试数据库的用例")
def test_db():
    assert 0

@allure.title("测试登录功能的类")
class TestCaseLogin:

    @allure.title("登录用例1")
    @allure.description("登录用例1的描述")
    def test_login_01(self):
        print('test case -01')
        assert 1

    @allure.title("登录用例2")
    @allure.description("登录用例2的描述")
    def test_login_02(self):
        print('test case -02')
        assert 1

feature和story

import pytest
import allure


@allure.feature("其他用例")
class TestOthers(object):

    @allure.story("其他用例类下的主页用例")
    @allure.title("主页用例")
    @allure.description("测试主页的用例")
    def test_index(self):
        assert 1

    @allure.story("其他用例类下的数据库用例")
    @allure.title("数据库用例")
    @allure.description("测试数据库的用例")
    def test_db(self):
        assert 0


@allure.feature("登录功能")
@allure.title("测试登录功能的类")
class TestCaseLogin:

    @allure.story("登录用例1")
    @allure.title("登录用例1")
    @allure.description("登录用例1的描述")
    def test_login_01(self):
        print('test case -01')
        assert 1

    @allure.story("登录用例2")
    @allure.title("登录用例2")
    @allure.description("登录用例2的描述")
    def test_login_02(self):
        print('test case -02')
        assert 1

image.png

SEVERITY

allure中对bug的严重（severity）级别也有定义，allure使用severity来标识测试用例或者测试类的bug级别，分为blocker，critical，normal，minor，trivial5个级别。一般，bug分为如下几个级别：

• Blocker级别：中断缺陷（客户端程序无响应，无法执行下一步操作），系统无法执行、崩溃或严重资源不足、应用模块无法启动或异常退出、无法测试、造成系统不稳定。
• Critical级别：即影响系统功能或操作，主要功能存在严重缺陷，但不会影响到系统稳定性。比如说一个服务直接不可用了，微信不能发消息，支付宝不能付款这种，打开直接报错。
• Major：即界面、性能缺陷、兼容性。如操作界面错误（包括数据窗口内列名定义、含义是否一致）、长时间操作无进度提示等。
• Normal级别：普通缺陷（数值计算错误），是指非核心业务流程产生的问题，比如说知乎无法变更头像，昵称等。这个要看自己的定义。
• Minor/Trivial级别：轻微缺陷（必输项无提示，或者提示不规范），比如各种影响体验，但不影响使用的内容。

import pytest
import allure


@allure.feature("其他用例")
class TestOthers(object):

    @allure.severity(allure.severity_level.BLOCKER)
    @allure.story("其他用例类下的主页用例")
    @allure.title("主页用例")
    @allure.description("测试主页的用例")
    def test_index(self):
        assert 1
    @allure.severity(allure.severity_level.CRITICAL)
    @allure.story("其他用例类下的数据库用例")
    @allure.title("数据库用例")
    @allure.description("测试数据库的用例")
    def test_db(self):
        assert 0


@allure.feature("登录功能")
@allure.title("测试登录功能的类")
class TestCaseLogin:
    @allure.severity(allure.severity_level.MINOR)
    @allure.story("登录用例1")
    @allure.title("登录用例1")
    @allure.description("登录用例1的描述")
    def test_login_01(self):
        print('test case -01')
        assert 1
    @allure.severity(allure.severity_level.TRIVIAL)
    @allure.story("登录用例2")
    @allure.title("登录用例2")
    @allure.description("登录用例2的描述")
    def test_login_02(self):
        print('test case -02')
        assert 1

    @allure.severity(allure.severity_level.NORMAL)
    @allure.story("登录用例3")
    @allure.title("登录用例3")
    @allure.description("登录用例3的描述")
    def test_login_03(self):
        print('test case -03')
        assert 0

image.png

优点：我们能通过查看severity的图，来清晰看到都不同的bug分布和级别，从而方便我们优先修复哪
些bug

dynamic

该参数常用于跟参数化搭配，为用例添加一些相关信息

import pytest
import allure

l = [
    {"url": "baidu.com", "title": "百度", "desc": "测试百度接口", 'method':"get", 'severity': "NORMAL"},
    {"url": "zhihu.com", "title": "知乎", "desc": "测试知乎接口", 'method':"get", 'severity': "TRIVIAL"},
]

@pytest.mark.parametrize("item", l)
def test_case(item):
    print(item['url'])
    allure.dynamic.title(item['title'])
    allure.dynamic.description(item['desc'])
    assert 1