pytest系列——allure命令行参数详解

一、查看allure 命令的帮助文档

allure -h

allure 命令的语法格式

allure [options] [command] [command options]

options 列表

Options:
    --help 命令行帮助文档
    -q, --quiet
      切换至安静模式
      Default: false
    -v, --verbose
      切换至冗长模式
      Default: false
    --version
      版本信息
      Default: false

command 列表

generate
serve
open
plugin

二、generate 命令行参数

作用

生成 allure 的html 报告

语法格式

generate [options]  allure结果目录

【注】：allure 结果目录就是运行 pytest 命令时--alluredir 跟的那个目录： pytest -sq --alluredir= ./allure

命令选项

最常用的就是 -o 与 -c 两个命令行参数。

三、open 命令行参数：结合generate 命令行参数一起使用

作用

打开已经生成的 allure 测试报告，就是打开 generate 命令生成的报告。

语法格式

open [options] allure报告目录

【注】：allure 报告目录就是运行 allure generate 命令时-o 跟的那个目录： allure generate -o ./allure-report

命令选项

四、serve 命令行参数

作用

​启动 allure 服务，打开 allure 报告。【区分与open命令行参数的区别】

语法格式

serve [options] allure结果目录

【注】：allure 结果目录就是运行 pytest 命令，--alluredir 跟的那个目录： pytest -sq --alluredir= ./allure

命令选项

五、浏览器打开 allure 报告的两种方式

①allure serve

# 执行 pytest，指定 allure 结果目录
pytest -sq --alluredir=./allure

# 打开 allure 报告
allure serve ./allure

②allure generate + allure open

# 执行 pytest，指定 allure 结果目录
pytest -sq --alluredir=./allure

# 生成 allure 的 html 报告
allure generate -c -o ./allure-report ./allure

# 打开 allure 报告
allure open ./allure-report

【注意】生成allure的html报告也可以：

allure generate report\tmp -o report\allure-report -c report\allure-report

两种方式的区别：

①第一种方式是将allure测试报告的原始数据（xml/json/text/attach等文件）直接在浏览器打开allure测试报告；而不在本地生成任何文件。

②第二种方式是首先在本地生成allure测试报告。然后在使用命令在浏览器打开allure测试报告。【此时allure测试报告原始数据仍然存在，而且会生成一个生成后的allure测试报告目录】

第二种方式支持直接在pycharm中选择浏览器打开 index.html 同样可以看到allure测试报告。【第一种方式不生成 index.html ，只能通过 allure server 打开测试报告】；但是如果在使用generate的方式生成allure测试报告之后，需要将此报告展示给其他人观看，同样需要 allure open ./allure-report 开启一个web服务供其他主机查看。