pytest-xlsx 2.0 (一)：快速上手

环境依赖

pytest-xlsx 的使用环境为： python >=3.12 和 pytest>=8.2

具体依赖如下：

python>=3.12

pytest>=8.2

openpyxl~=3.0

pyyaml~=6.0

安装插件

pip install pytest-xlsx -U

使用插件

01

添加配置

鉴于 excel 文件应用广泛，为了避免误操作，本插件需要通过配置文件手动启用后才会生效。

具体来说：

在根目录创建 pytest.ini，并写入下面这些内容：

# pytest.ini[pytest]

# 执行xlsx用例xlsx_run_case = true

# 指定meta列，用来解析内容xlsx_meta_column_name  = 关键字

02

创建用例

创建 xlsx 文件用例，并在 meta 列（本例中为 关键字 ） 编写解析标记

注意：文件名必须是 test_ 开头，以此和非用例的 xlsx 进行区分

其中有两个内置标记将被插件解析，其他标记则传递给钩子函数进行解析：

name：必填，不可重复，用指定明用例名称

mark：选填，可重复，用来添加 pytest 标记

为了简化逻辑便于理解，我们约定： 总是以 name 标记作为一个用例的开始

例如：

test_demo.xlsx

03

编写钩子

插件在执行 xlsx 用例时，将name和mark之外内容，依次传递给钩子pytest_xlsx_run_step()。

所以，创建钩子，即可得到每一个具体步骤，并根据步骤内容完成相应的动作。

注意：钩子应该返回 True，以便后续的同名钩子不再执行

conftest.py

04

执行用例

启动 pytest 框架即可加载和执行 XLSX 用例

pytest执行结果

下一步

现在你已经可以用 pytest 执行 xlsx 文件用例了，

接下来，可以继续学习在 xlsx 文件中使用 mark、fixture、数据驱动、变量、函数等内容。

此外，也可以在 xlsx 文件中使用其他的 pytest 插件（通常是 mark 或 fixture 的方式）

能看到这里说明是真爱，关注一下吧