一、Allure介绍
Allure是Pytest用于生成测试报告的框架,提供丰富的测试报告功能;
二、Allure安装
Allure安装分为2块,分别是pytest-Allure库安装,本地生成报告并导出的命令行allure安装;
1、pytest-Allure库安装
pip install allure-pytest
2、allure命令行工具安装
(1)安装jdk依赖(如果已安装则可忽略)
- 下载路径:下载路径
- 安装成功后,添加环境变量
- 测试安装成功:命令行输入Java
(2)下载allure命令行工具:https://github.com/allure-framework/allure2/releases
(3)下载zip到本地,解压到某个目录,添加bin目录到环境变量
(4)环境变量添加成功后,测试是否成功
allure --version
,如果添加成功,则会出版本;如果添加失败,则提示“allure是未知命令”
三、Pytest-Allure相关方法
@allure.epic():用于类级别
@allure.feature():用于类级别
以下是测试用例级别:
@allure.severity('normal')
@allure.story('故事1:获取天气数据')
@allure.title('获取单个城市的天气')
@allure.description('获取深圳的天气')
@allure.test服务器托管网case('测试用例地址:www.***.com')
@allure.issue('缺陷管理地址:https://www.zentao.net/')
@allure.tag('这是tag')
四、Allure生成和导出报告
1、Allure生成报告
在生成报告的过程中,用的是pytest-alliure,pytest-allure在用例执行过程中,监听执行结果并记录下来
# 在运行测试用例时,--alluredir指定生成目录
pytest --alluredir=reports
或者
pytest.main(["testcases/Android/advertise", '--alluredir=allure-results'])
2、Allure命令行导出报告
allure导出并打开报告,有2种方式,一是使用allure generate +open、二是使用allure server,如下
方式一、allure open allure-report
(1)导出报告使用的是allure命令行
# XXX为--alluredir指定生成的目录
# 导出报告到当前XXX目录下,会自动生成一个allure-report文件夹
# 注意XXX使用绝对路径,比如:D:QAantoTestXXallure-results
allure generate XXX
# 使用-o/--report-dir/--output导出allure-report到对应的XXX2文件夹
# XXX为--alluredir指定生成的目录,使用绝对路径,同上面
allure generate XXX -o XXX2
# 如果已有导出的allure-report,则需要使用-c/--clean选项
allure generate XXX --clean
或者
allure generate XXX -c
或者
allure generate XXX -o XXX2 --clean
或者
allure generate XXX -o XXX2 -clean
(2)打开报告到浏览器
# 打开XXX3下的报告到浏览器
# XXX3是生成allure-report的目录,使用绝对路径
allure open XXX3
方式二、allure serve
# 打开 allure 报告
# XXX为--alluredir指定生成的目录,使用绝对路径
allure serve XXX
区别
(1)方式一会先导出allure-report,可以直接打开目录下的index_html文件;方式二将allure测试报告的原始数据(xml/json/text/attach等文件)直接在浏览器打开allure测试报告,而不在本地生成任何文件。
(2)方式二虽然不会在本地生成任何文件,但看bash输出,是会先创建temp临时文件导出a服务器托管网llure-report,再直接打开,两者无本质区别。
五、allure报告详解
Overview:整体数据显示,用例数目,通过率、suites测试集信息、feature模块
Categories:“类别”选项卡提供了创建自定义缺陷分类、应用测试结果的方法,可以查看具体的错误输出
Suites:用例集合,按照套件(testcases.Android.advertise)和类分组,已执行测试的结构展示,也可查看每个用例的信息
Graphs:用图表显示测试数据中收集的不同统计数据,状态分解或严重性和持续时间图
Timeline:时间轴选项卡可视化测试执行的回顾,allure适配器收集测试的精确时间
Behaviors:对于场景驱动,此选项卡根据Epic、Feature和Story标记对测试结果进行分组。
Packages:按不同的包名分组,有多个模块的测试用例时,使用更清晰
六、allure命令行详解
1、查看Allure帮助文档
allure -h
2、allure命令行格式
allure [options] [command] [command options]
Options:
–help 命令行帮助文档
-q, –quiet 切换至安静模式 Default: false
-v, –verbose 切换至冗长模式 Default: false
–version 版本信息 Default: falsecommand 列表
generate
serve
open
plugin
注:每个command对应不同的command option,可通过allure –help
服务器托管,北京服务器托管,服务器租用 http://www.fwqtg.net