Pytest+Allure生成HTML图形化测试报告 一、环境配置 3、验证安装是否成功与问题解决方法 二、生成html报告命令 三、定制报告
1、安装Python依赖库
pip install pytest pip install pytest-allure-adaptor # pytest-allure-adaptor库可以替换为pytest-allure-adaptor2
2、安装allure-commandline工具
下载的allure-commandline为ZIP压缩包，需要将解压文件中bin目录设置为环境变量。
注意：不要将allure-commandline解压在Program Files (x86)目录中，否则运行会报错
allure-commandline百度云盘下载：
链接：https://pan.baidu.com/s/1o2ptbdOKq2qOQYkQ0z2pKg
提取码：wevw
官网下载地址：
https://www.mvnjar.com/ru.yandex.qatools.allure/allure-commandline/1.5.3/detail.html
3、验证安装是否成功与问题解决方法
在命令行输入pytest和allure，若提示如下错误信息，是因为我们没有将python目录下的Scripts目录配置到环境变量中
将python目录下的Scripts目录配置到环境变量后，再次输入pytest，返回如下信息，则表示pytest安装成功。
但是当我们在命令行输入allure，却返回错误信息“此时不应有 Python36-32allure-commandlinein..”，产生问题的原因是我们把allure-commandline解压到“Program Files (x86)”中，需要更换安装路径为“Program Files”。
当更换allure-commandline目录后，再次输入allure，可能还会返回错误信息“此时不应有javajdk1.8.0_17lib”，此时可能需要安装64位的JDK（我没试过更换目录，直接重新安装的64位JDK，所以不清楚直接更换目录是否有用）
当输入allure返回如下界面，则表示allure安装成功
二、生成html报告命令
1、使用pytest生成xml报告
pytest --alluredir [xml_report_path] # [xml_report_path]根据自己需要定义文件夹，作者定义为：/report/xml
用例执行完成之后会在[xml_report_path]目录下生成了一堆xml的report文件，当然这不是我们最终想要的美观报告。
运行结果如下：
2、使用 CommandTool 生成我们需要的美观报告。
allure generate [xml_report_path] -o [html_report_path] # [xml_report_path]为第一步生成xml报告的路径 # [html_report_path]为输出html报告的路径，作者定义为：/report/html
打开 index.html,测试报告就会呈现在你面前
注⚠️：直接用chrome浏览器打开报告，报告可能会是空白页面。
解决办法：
1、在pycharm中右击index.html选择打开方式Open in Browser就可以了。
2、使用Firefox直接打开index.html。
打开后界面如下
三、定制报告
- Feature: 功能块，feature功能分块时比story大,即同时存在feature和story时,feature为父节点
- Story: 功能块，具有相同feature或story的用例将规整到相同模块下,执行时可用于筛选
- Severity: 标注测试用例的重要级别，包含blocker, critical, normal, minor, trivial 几个不同的等级
- Step: 标注测试用例步骤
- Issue：问题标识，关联标识已有BUG的问题，可为一个url链接地址
- TestCase: # 用例标识，关联标识用例，可为一个url链接地址
- attach: 标注一些附加内容到测试报告中
- Environment: 标注环境Environment字段
1、Features定制详解
- Feature: 功能块，feature功能分块时比story大,即同时存在feature和story时,feature为父节点
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}文件feature标注的第一个用例") def test_case1(): a = 1 b = 1 c = a + b assert c == 2 @allure.feature(f"{fileName}文件feature标注的第二个用例") def test_case2(): a = "aaaaaaaaa" assert len(a) == 10
2、Story定制详解
- Story: 功能块，具有相同feature或story的用例将规整到相同模块下,执行时可用于筛选
import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}文件feature标注的用例") @allure.story(f"{fileName}文件story标注的第一个用例") def test_case1(): a = 1 b = 1 c = a + b assert c == 2 @allure.feature(f"{fileName}文件feature标注的用例") @allure.story(f"{fileName}文件story标注的第二个用例") def test_case2(): a = "aaaaaaaaa" assert len(a) == 10
3、用例标题和用例描述定制详解
def的方法名称为用例名称，3引号注释为用例描述
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}") def test_caseName1(): # test_caseName1为用例title """ 用例描述：这是test_caseName1的用例描述 """ # 3引号注释为用例描述 a = 1 b = 1 c = a + b assert c == 2 @allure.feature(f"{fileName}") def test_caseName2(): a = "aaaaaaaaa" assert len(a) == 10
4 、Severity定制详解
- Severity: 标注测试用例的重要级别，包含blocker, critical, normal, minor, trivial 几个不同的等级
Allure中对严重级别的定义：
1、 Blocker级别：中断缺陷（客户端程序无响应，无法执行下一步操作）
2、 Critical级别：临界缺陷（ 功能点缺失）
3、 Normal级别：普通缺陷（数值计算错误）
4、 Minor级别：次要缺陷（界面错误与UI需求不符）
5、 Trivial级别：轻微缺陷（必输项无提示，或者提示不规范）
1、 Blocker级别：中断缺陷（客户端程序无响应，无法执行下一步操作）
2、 Critical级别：临界缺陷（ 功能点缺失）
3、 Normal级别：普通缺陷（数值计算错误）
4、 Minor级别：次要缺陷（界面错误与UI需求不符）
5、 Trivial级别：轻微缺陷（必输项无提示，或者提示不规范）
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}") @allure.story("正向用力") @allure.severity('blocker') def test_case1(): a = "aaaaaaaaa" assert len(a) == 10 @allure.feature(f"{fileName}") @allure.story("正向用力") @allure.severity('critical') def test_case2(): a = "aaaaaaaaa" assert len(a) == 9 @allure.feature(f"{fileName}") @allure.story("反向用力") @allure.severity('normal') def test_case3(): a = "aaaaaaaaa" assert len(a) == 10 @allure.feature(f"{fileName}") @allure.story("反向用力") @allure.severity('minor') def test_case4(): a = "aaaaaaaaa" assert len(a) == 9 @allure.feature(f"{fileName}") @allure.story("反向用力") @allure.severity('trivial') def test_case5(): a = "aaaaaaaaa" assert len(a) == 9
5、Step定制详解
- 标注测试用例步骤
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}") @allure.story("正向用力") @allure.step('用例步骤') def test_case1(): """ 用例描述：计算两步相加之和 """ with allure.step('step1:返回a的值'): a = 1 with allure.step('step2:返回b的值'): b = 2 with allure.step('step3:预期a+b=3'): assert a + b == 4
6、Issue和TestCase定制详解
- Issue：问题标识，关联标识已有BUG的问题，可为一个url链接地址
- TestCase: # 用例标识，关联标识用例，可为一个url链接地址
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}") @allure.story("正向用力") @allure.step('用例步骤') @allure.issue("http://www.baidu.com") @allure.testcase("http://www.testlink.com") def test_case1(): """ 用例描述：计算两步相加之和 """ with allure.step('step1:返回a的值'): a = 1 with allure.step('step2:返回b的值'): b = 2 with allure.step('step3:预期a+b=3'): assert a + b == 4
7、Environment定制详解
- Environment: 标注环境配置Environment字段
# coding=utf-8 import allure allure.environment(app_package='com.mobile.fm') allure.environment(test="hhhhhh") allure.environment(域名="127.0.0.1")
8、attach定制详解
在报告中增加附件：allure.attach(’arg1’,’arg2’,’arg3’)：arg1：是在报告中显示的附件名称arg2：表示添加附件的内容arg3：表示添加的类型(支持:HTML,JPG,PNG,JSON,OTHER,TEXTXML)
# coding=utf-8 import os import allure fileName = os.path.split(os.path.realpath(__file__))[1] @allure.feature(f"{fileName}") @allure.story("正向用力") @allure.step('用例步骤') def test_case1(): """ 用例描述：计算两步相加之和 """ with allure.step('step1:返回a的值'): allure.attach('背景1', '没有背景') # attach可以打印一些附加信息 allure.attach('背景2', '没有背景') a = 1 with allure.step('step2:返回b的值'): with open(r"C:UsersAdministratorDesktopqwe.jpg","rb") as f: f = f.read() allure.attach('图片',f,allure.attach_type.JPG) b = 2 with allure.step('step3:预期a+b=3'): assert a + b == 4