一、环境安装
1. 介绍
- allure是一个轻量级的,灵活的,支持多语言的测试报告工具
- 多平台,奢华的report框架
- 可以为dev/qa提供详尽的测试报告、测试步骤、log
- 也可以为管理层提供high level 统计报告
- Java语言开发,支持pytest,JavaScrpit,PHP,ruby
- 可以集成到Jenkins
2. 安装
allure安装分为2块,如下:
- allure-pytest库安装
- 本地生成报告并导出的命令行allure安装
2.1 pip命令行安装allure-pytest
pip install allure-pytest
2.2 安装命令行allure
- 安装jdk
参考:01_环境安装
注意:如上述链接无法打开,请在网上查询其他教程
-
访问allure下载地址进行下载,下载zip格式即可
-
解压allure压缩包,把压缩包复制到指定目录,进入文件夹bin中,双击其中的allure.bat文件,会有一个窗口一闪而过,说明已安装成功一半
-
配置allure的环境变量,在path中加入allure的bin目录地址
-
配置完成后,在cmd或者powershell中输入allure,显示如下说明安装allure成功
3. 使用
3.1 生成allure报告所需数据
pytest --alluredir=报告所需数据路径(绝对路径或者相对路径)
注意:存放allure报告所需数据的路径要和allure报告存放的路径分开,即不能一致

3.2 生成allure报告(根据打开allure报告方式决定是否执行此步骤)
allure generate -c -o 报告路径 报告所需数据路径

3.3 打开allure报告
打开报告有三种方式
3.3.1
使用allure serve
命令
allure serve 报告所需数据路径
执行上述命令,allure报告会自动打开,显示如下:


3.3.2
allure generate
生成html格式的测试结果报告,并使用allure open
来打开报告
allure generate -c -o 报告路径 报告所需数据路径
allure open -h xxx -p xxx 报告路径
执行上述命令后,allure报告会自动打开,显示如下:


执行
allure open
命令会启动一个Web服务,将已经生成的html测试报告在默认的浏览器中打开,地址为指定的ip和port,如未指定,则会自动指定注意:allure open命令可指定ip和port打开allure报告
3.3.3
上述两种打开方式都需要启动Web服务,否则无法打开allure报告,使用allure-combine
会生成静态html报告(complete.html
),不需要启动Web服务,即第三种打开allure报告,如下:

allure-combine 报告路径 --dest 报告路径
执行上述命令后,allure报告不会自动打开,显示如下:


注意:执行allure-combine命令前,需要先安装
allure-combine
3.3.4 打开allure报告区别
-
allure serve
和allure open
方式都需要启动Web服务,否则无法打开allure报告,使用allure-combine
会生成静态html报告(complete.html
),不需要启动Web服务,执行完后点击complete.html文件,可直接查看报告 -
allure serve
方式打开只需要生成allure报告所需数据,allure open
方式不仅需要生成allure报告所需数据,且还要生成allure报告 -
allure open
方式生成报告之后,点击报告所在目录的报告(index.html
),不会正常显示报告,会一直显示loading,但是在pycharm中打开报告,报告内容可正常显示
参考:allure报告官方文档
4. 其他
4.1 allure报告环境配置
4.1.1 添加environment.properties文件来添加环境配置
- 打开报告之前,在下述路径中(报告所需数据路径)创建
environment.properties
文件,格式如下:
pytest --alluredir=报告所需数据路径(绝对路径或者相对路径)
host=10.10.10.10
branch=1.0.0
level=SMOKE_TEST
注意:文件名固定,不可更改
-
执行打开报告命令,显示如下:
二、allure与jenkins的集成
暂无,后续更新
网友评论