Pytest Allure 命令行参数详解:generate、serve 与 open 用法

晚来风
晚来风
发布时间:2026-10-12 | 4人浏览过
原创

本文详细介绍 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 命令行参数的内容,请搜索本站以前的文章或继续浏览下面的相关文章。希望大家以后多多支持本站!

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表