Pytest Allure 命令行参数详解:generate、serve 与 open 用法
本文详细介绍 Pytest 结合 Allure 时常用的三个命令行工具:generate、serve 和 open。重点讲解 generate 命令生成 HTML 报告及 -c、-o 参数的使用,serve 命令直接启动服务查看报告,以及 open 命令打开指定目录报告的具体语法和注意事项,帮助开发者高效管理测试报告。
首先,我们可以通过查看 Allure 命令的帮助文档来了解其基本用法。
在命令行终端中输入以下命令即可查看帮助信息:
allure -h
Allure 命令的基本语法格式如下所示:
allure [options] [command] [command options]
在帮助文档中,Options(选项)列表包含了常用的全局配置参数。
Options:
--help 命令行帮助文档
-q, --quiet
切换至安静模式
Default: false
-v, --verbose
切换至冗长模式
Default: false
--version
版本信息
Default: false
Command(命令)列表则列出了 Allure 支持的主要操作指令。
- generate:用于生成测试报告。
- serve:用于启动本地服务查看报告。
- open:用于直接打开生成的报告文件。
- plugin:用于管理插件。
本文将重点介绍前三个最常用的命令:generate、serve 和 open。
generate 命令参数详解
该命令的主要功能是处理测试数据。
具体而言,它负责生成 Allure 格式的 HTML 报告文件。
其基本语法格式为:
generate [options] allure 结果目录
注意:Allure 的结果目录通常由运行 pytest 命令时通过 --alluredir 参数指定的目录决定。
pytest -sq --alluredir= ./allure
在使用 generate 命令时,有一些常用的命令选项需要注意。

其中,-c 和 -o 是两个最常用的参数,分别用于指定配置文件和输出目录。
open 命令参数详解
该命令的主要作用是启动浏览器。
具体来说,它用于打开由 generate 命令生成的 Allure 报告文件。
其基本语法格式为:
open [options] allure报告目录
注意:Allure 报告目录通常由运行 allure generate 命令时通过 -o 参数指定的目录决定。
allure generate -o ./allure-report
在使用 open 命令时,可以配合使用特定的命令选项。

serve 命令参数详解
该命令的主要功能是启动本地服务器。
通过该命令,可以直接在浏览器中查看 Allure 报告。
其基本语法格式为:
serve [options] allure 结果目录
注意:Allure 的结果目录同样由运行 pytest 命令时通过 --alluredir 参数指定的目录决定。
pytest -sq --alluredir= ./allure
在使用 serve 命令时,可以配合使用特定的命令选项。

以下是通过浏览器查看 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
当然,如果不指定 -o 参数,默认情况下也会生成到 allure-report 目录。
接下来,我们来看一下 allure-report 目录的具体结构。

- 这种方式的目录结构更加清晰,不仅仅包含一堆 JSON 文件。
- 此外,直接打开目录下的 index.html 文件也能正常查看 Allure 报告。
至此,关于 Pytest Allure 命令行参数使用的介绍就结束了。如需了解更多相关 Pytest Allure 命令行参数的内容,请搜索本站以前的文章或继续浏览下面的相关文章。希望大家以后多多支持本站!
免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。









