接口自动化-allure测试报告

学习目标：

1、测试报告的作用

2、allure的安装

3、allure的基本使用

4、allure的高级使用

学习内容：

1、测试报告的作用

自动化接口的结果呈现虽然可以通过日志文件去查看用例的成功或者失败，但是这样的结果就是不美观，不能情绪的从整体的去查看到底哪些、模块的用例失败的多，失败多少。测试报告就能够很好的从结果上体现出你自动化的结果。在众多测试报告中，目前allure的测试报告是相对操作简单，结果能清晰呈现的报告。

2、allure的安装

安装allure需要注意两点，第一个是allure需要依赖java环境，第二个是安装好的allure需要配置到全局环境变量里面，这样才可以直接在终端使用。

2.1安装allure分成两部分：

2.1.1安装和python、pytest版本兼容的allure-pytest

版本： allure-pytest == 2.8.16

pip install allure-pytest==2.8.16 --index-url ?https://pypi.douban.com/simple

安装完成后，打开一个pytest脚本进行验证一下，如果报错：AttributeError:module 'allure' has no attribute...这样的报错是之前安装的 pytest-allure-adaptor 这个插件发生了冲突，这两个插件是不能共存的，去卸掉 pytest-allure-adaptor 这个就行了 （ pip uninstall pytest-allure-adaptor）

2.1.2安装 allure

版本：allure == 2.13.3

这是一个命令行的插件，需要去下载：

1、推荐下载地址之一： https://github.com/allure-framework/allure2/releases

2、下载后解压到自己的文件夹中；

3、配置环境变量

2.2 检查是否安装allure成功

在终端上打开allure，能打开就基本成功了

3、allure的基本使用

3.1 allure的常用使用方法可以下面的方式划分：

对用例来说（下面的关系都是有承接关系的，报告里面的内容也是这样显示的）：

用例步骤（@allure.step()）--单个测试点（@aluure.title）--测试功能(@allure.story)--测试模块（@allure.feature）--测试产品（@allure.epic）

对于其他的功能（这些标记的最后都是会在测试报告里面呈现的）：

给用例标记下bug来源：@allure.issue()

给用例标记用例的来源：@allure.testcase()

给用例补充描述：@allure.description()

给用例标记等级：@allure.severity()

给用例添加链接（我一般是添加对应的日志链接）：@allure.link()

给用例添加附件：@allure.attachment()

3.2 allure的运行：

第一步先生成allure需要的数据：

pytest 要运行的py文件 --alluredir 保存生成文件的目录

例如：pytest allure_demo.py --alluredir ../report/allure_report

第二步把生成的文件加载到allure报告中

例如：allure serve ../report/allure_report

使用生成报告提供的地址在浏览器中就可以打开报告了

4、allure的高级使用

4.1 allure的用例等级划分：

blocker　 阻塞缺陷（功能未实现，无法下一步）

critical　　严重缺陷（功能点缺失）

normal　　 一般缺陷（边界情况，格式错误）

minor　 次要缺陷（界面错误与ui需求不符）

trivial　　 轻微缺陷（必须项无提示，或者提示不规范）

4.2 只执行某些allure标记的用例参数

例如想执行story为story1的用例:

pytest allure_demo.py --alluredir ../report/allure_report --allure-stories="用户故事1"

4.3 把日志目录配置上

主要是在allure的attach或者是link上附上失败日志文件或者上目录即可