1-Pytest全栈自动化测试指南- 运行

off999 2025-07-27 23:17 35 浏览 0 评论

通常，使用命令调用 pytest（有关调用 pytest 的其他方法，pytest请参见下文）。这将在名称遵循表单的所有文件中或在当前目录及其子目录中执行所有测试。更一般地说，pytest 遵循标准测试发现规则。test_*.py*_test.py、

指定要运行的测试

Pytest 支持多种从命令行运行和选择测试的方法。

在模块中运行测试

pytest test_mod.py

在目录中运行测试

pytest testing/

通过关键字表达式运行测试

pytest -k "MyClass and not method"

这将运行包含与给定字符串表达式匹配的名称（不区分大小写）的测试，其中可以包括使用文件名、类名和函数名作为变量的 Python 运算符。上面的例子会运行TestMyClass.test_something ，但不会TestMyClass.test_method_simple。

按节点 ID 运行测试

每个收集到的测试都被分配一个唯一的nodeid，它由模块文件名和后面的说明符组成，如类名、函数名和参数化的参数，用::字符分隔。

要在模块中运行特定测试：

pytest test_mod.py::test_func

在命令行中指定测试方法的另一个示例：

pytest test_mod.py::TestClass::test_method

通过标记表达式运行测试

pytest -m slow

将运行所有用@pytest.mark.slow装饰器装饰的测试。

有关详细信息，请参阅标记。

从包运行测试

pytest --pyargs pkg.testing

这将导入pkg.testing并使用其文件系统位置来查找和运行测试。

获取版本、选项名称、环境变量的帮助

pytest --version # shows where pytest was imported from
pytest --fixtures # show available builtin function arguments
pytest -h | --help # show help on command line and config file options

分析测试执行持续时间

在 6.0 版中更改。

要获得超过 1.0 秒的最慢 10 个测试持续时间的列表：

pytest --durations=10 --durations-min=1.0

默认情况下，pytest 不会显示太小（<0.005s）的测试持续时间，除非-vv在命令行上传递。

管理插件的加载

早期加载插件

-p您可以使用以下选项在命令行中显式地提前加载插件（内部和外部）：

pytest -p mypluginmodule

该选项接收一个name参数，可以是：

完整的模块名称，例如myproject.plugins. 这个带点的名称必须是可导入的。
插件的入口点名称。setuptools这是插件注册时传递给的名称。例如，要提前加载pytest-cov插件，您可以使用：
pytest -p pytest_cov

禁用插件

要在调用时禁用加载特定插件，请将该-p选项与前缀一起使用no:。

示例：要禁用加载doctest负责从文本文件执行 doctest 测试的插件，请像这样调用 pytest：

pytest -p no:doctest

调用 pytest 的其他方式

您可以从命令行通过 Python 解释器调用测试：

python -m pytest [...]

这几乎等同于直接调用命令行脚本，只是调用 via还会将当前目录添加到.pytest [...]pythonsys.path

从 Python 代码调用 pytest

retcode = pytest.main()

这就像您从命令行调用“pytest”一样。它不会引发SystemExit而是返回退出代码。您可以传入选项和参数：

retcode = pytest.main(["-x", "mytestdir"])

您可以指定其他插件pytest.main：

# content of myinvoke.py
import sys
import pytest
class MyPlugin:
def pytest_sessionfinish(self):
print("*** test run reporting finishing")

if __name__ == "__main__":
sys.exit(pytest.main(["-qq"], plugins=[MyPlugin()]))