一、html-report测试报告
html-report测试报告。是pytest下基本的测试报告。要使用pytest-html测试报告,就要确保python版本在3.6及以上即可。本身pytest所提供的测试结果汇总,是基于控制台的文本输出形式。
pytest-html是基于HTML格式实现的测试报告的结果记录。属于pytest下的插件。所以要调用的话,需要提前安装这个插件。
安装指令:
pip install pytest-html pip源自行添加
在实际的pytest运行过程中,如果需需要生成测试报告,则需要添加指令 --html=测试报告名称.html。
import pytest
@pytest.fixture
def first():
return 'a'
def test_function(first):
print(first+'hcc')
直接运行也能得到日志报告,但是不够直观 ,可以运行:
pytest -s -v test_html_report.py --html=./report.html
得到html文件:
注意: 默认生成html测试报告的指令 --html=测试报告.html,不会捕获页面所显示的日志信息。如果要捕获日志信息,则需要添加指令 --capture=sys如果要将测试报告进行邮件或者其他途径的分享,需要添加指令--self-contained-html。将测试报告的css样式直接加载到html文件之中,不再额外生成css样式文件夹。
二、Allure测试报告
Allure测试报告是自动化测试领域下的测试报告天花板。本身是适配到Python自动化、Java自动化都可以满足的一种测试报告。属于独立化的一个测试报告插件。
环境部署:
Allure安装:
下载安装包,解压到指定路径,进入到allure的bin路径下,复制bin的完整路径,添加到系统环境变量的path之中
启动cmd,运行allure --version指令,如果在控制台显示有allure版本信息则表示安装成功
allure-pytest安装:
pip install allure-pytest进行安装
2.1 mac下allure安装
方法一:使用终端
1、打开终端
brew install allure
2、安装完成后验证是否成功
allure --version方法二:安装包+终端
1、下载allure安装包,tzg或者zip
https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/
2、解压安装包,放到合适的位置
3、打开终端vi ~/.bash_profile
4、回车按E,进入编辑页面,按“i”进入编辑状态
5、添加以下两行export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin
export PATH=${PATH}:自己本地allure的bin目录的路径
6、按esc退出编辑状态,输入:wq退出编辑页
7、刷新配置文件source ~/.bash_profile
8、验证allure是否配置成功
allure --version
2.2 allure的使用
Allure测试报告的生成: 1. 安装allure测试报告 2. pytest --alluredir 指令用于将测试结果的数据保存在allure结果之中 3. allure serve ./allure_report 这个指令是生成临时allure测试报告。并提供web服务以供访问 生成的测试报告保存在用户的缓存临时文件夹下,路径无法修改 4. allure generate ./allure_report -o ./report_allure 这个指令是将allure采集的测试数据生成为完整的allure测试报告,保存在指定路径下。
import pytest
@pytest.fixture
def first():
return 'a'
def test_function(first):
print(first+'hcc')
运行指令: pytest --alluredir ./allure_report
将测试结果的数据保存在allure结果之中,同时生成一个测试报告文件。
allure serve ./allure_report 这个指令是生成临时allure测试报告。并提供web服务以供访问。生成一个完整的测试报告。
因为pytest下的allure测试报告生成,需要调用allure指令,这个指令和pytest没有关系,所以想要一步实现数据的记录以及报告的生成,记得添加os.system()方法来调用allure指令。但是,可能allure指令调用会失败。
如果是通过指令运行,集成到pytest之中,生成allure测试报告的话,这个测试报告想要分享,可以在Jenkins中进行集成的方式来做分享(也就是通过链接进行分享的模式)。
如果想要关联持续集成,做到更加完整的自动化测试效果,可以通过allure来实现测试报告的生成。
三、Allure装饰器使用
在Allure测试报告之中,进行了非常详细的数据的展示,包括各种分类、图形化界面等。同时,对于自动化测试用例的执行,在Allure中也可以做到一定量的管理,让整个测试报告变得更加完整。
Allure如何更加美观地展示所有的测试内容呢?可以通过各类不同的装饰器来丰富测试报告相关信息。让整个报告看起来更加完整,易读,易理解。
- epic装饰器:用于定义整个测试的描述信息,可以理解为总的测试说明,如果输入的参数是相同的 例如: 当前执行了某一个系统的一个完整业务流程,通过不同的epic装饰器实现对不同的业务流程的总描述
feature装饰器:用于定义到当前用例执行的功能模块的说明
tory装饰器:对流程分支进行的定义与描述
title装饰器:实现当前用例名称的定义
escription装饰器:主要实现对用例的内容进行自定义的描述,也可以通过三引号的注释操作来实现同样的效果。需要注意为了代码的规范性,建议统一用一种方法
step装饰器:用于显示测试的操作步骤。 装饰器形态的step可以对当前用例进行步骤的统一描述,无法实现对用例的所有步骤进行细化的处理 with allure.step('步骤描述')的方式可以实现对用例之中所有的不同操作步骤,进行细化的步骤描述,当出现问题的时候可以更加快速准确定位到出问题的点
3.1 epic装饰器
epic装饰器:用于定义整个测试的描述信息,可以理解为总的测试说明,如果输入的参数是相同的 例如: 当前执行了某一个系统的一个完整业务流程,通过不同的epic装饰器实现对不同的业务流程的总描述。
import pytest
import os
import allure
@allure.epic("这是测试总说明")
def test_function01():
print('这是1号测试用例')
@allure.epic("这是测试总说明")
def test_function02():
print('这是2号测试用例')
@allure.epic("这是测试总说明")
def test_function03():
print('这是3号测试用例')
@allure.epic("这是测试总说明1")
def test_function04():
print('这是4号测试用例')
@allure.epic("这是测试总说明1")
def test_function05():
print('这是5号测试用例')
if __name__ == '__main__':
pytest.main(['-s', '-v', '--alluredir=./allure_report'])
os.system(r'allure generate ./allure_report -o ./report_allure --clean')
查看测试报告:
3.2 feature装饰器
feature装饰器:用于定义到当前用例执行的功能模块的说明
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
def test_function01():
print('这是1号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
def test_function02():
print('这是2号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('添加购物车功能模块')
def test_function03():
print('这是3号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('商品详情功能模块')
def test_function04():
print('这是4号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('支付功能模块')
def test_function05():
print('这是5号测试用例')
查看测试报告:
3.3 story装饰器
story装饰器:对流程分支进行的定义与描述
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
def test_function01():
print('这是1号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
def test_function02():
print('这是2号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('添加购物车功能模块')
@allure.story('实现购物车添加操作行为')
def test_function03():
print('这是3号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('商品详情功能模块')
@allure.story('实现商品属性的获取')
def test_function04():
print('这是4号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('支付功能模块')
@allure.story('实现支付的操作行为')
def test_function05():
print('这是5号测试用例')
查看测试报告:
3.4 title装饰器
title装饰器:实现当前用例名称的定义
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
@allure.title('登录操作')
def test_function01():
print('这是1号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
@allure.title('验证账号')
def test_function02():
print('这是2号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('添加购物车功能模块')
@allure.story('实现购物车添加操作行为')
@allure.title('添加购物车')
def test_function03():
print('这是3号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('商品详情功能模块')
@allure.story('实现商品属性的获取')
@allure.title('选择商品属性')
def test_function04():
print('这是4号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('支付功能模块')
@allure.story('实现支付的操作行为')
@allure.title('进行支付')
def test_function05():
print('这是5号测试用例')
查看测试报告:
3.5 escription装饰器
escription装饰器:主要实现对用例的内容进行自定义的描述,也可以通过三引号的注释操作来实现同样的效果。
import pytest
import os
import allure
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
@allure.title('登录操作')
@allure.description('实现用户的登录操作行为')
def test_function01():
print('这是1号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
@allure.title('验证账号')
@allure.description('对已登录登录进行账号的正确性验证行为')
def test_function02():
print('这是2号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('添加购物车功能模块')
@allure.story('实现购物车添加操作行为')
@allure.title('添加购物车')
@allure.description('实现添加购物车操作行为')
def test_function03():
print('这是3号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('商品详情功能模块')
@allure.story('实现商品属性的获取')
@allure.title('选择商品属性')
@allure.description('对测试商品的属性进行选择')
def test_function04():
print('这是4号测试用例')
@allure.epic("这是测试总说明")
@allure.feature('支付功能模块')
@allure.story('实现支付的操作行为')
@allure.title('进行支付')
@allure.description('实现对已选择的商品进行最终的支付处理')
def test_function05():
print('这是5号测试用例')
查看测试报告:
3.6 step装饰器
step装饰器:用于显示测试的操作步骤。 装饰器形态的step可以对当前用例进行步骤的统一描述,无法实现对用例的所有步骤进行细化的处理。
@allure.epic("这是测试总说明")
@allure.feature('登录功能模块')
@allure.story('实现登录的操作行为')
@allure.title('登录操作')
@allure.description('实现用户的登录操作行为')
@allure.step('进行用户的账号与密码输入')
def test_function01():
print('这是1号测试用例')
查看测试结果:
with allure.step('步骤描述')的方式可以实现对用例之中所有的不同操作步骤,进行细化的步骤描述,当出现问题的时候可以更加快速准确定位到出问题的点
def test_function01():
with allure.step('1.进行登录页的访问'):
print('这是1号测试用例1')
with allure.step('2.进行用户名称的输入‘):
print('这是1号测试用例2')
with allure.step('3.进行密码的输入'):
print('这是1号测试用例3')
with allure.step('4.进行登录按钮的点击'):
print('这是1号测试用例4')
查看测试结果:
装饰器形态的step可以对当前用例进行步骤的统一描述,无法实现对用例的所有步骤进行细化的处理 。
with allure.step('步骤描述')的方式可以实现对用例之中所有的不同操作步骤,进行细化的步骤描述,当出现问题的时候可以更加快速准确定位到出问题的点 。
Allure测试用例等级管理(参考缺陷等级定义),所有的用例默认为normal级别。用例可以分为以下几个 等级:
- 1. blocker 阻塞缺陷(功能未实现,无法继续下一步操作)
- 2. critical 严重缺陷
- 3. normal 一般缺陷
- 4. minor 次要缺陷
- 5. trivial 轻微缺陷
- 写法示例: 完整写法@allure.severity(allure.severity_level.BLOCKER) 简易写法 @allure.severity('critical')
- 严重级别可以通过类来直接进行定义,定义的效果就是将整个类的所有测试用例定义为当前的级别,normal以下无法定义为类级别