Pytest权威教程21-API参考-06-变量及异常

目录

• 特殊变量(Special Variables)
  • collect_ignore
  • collect_ignore_glob
  • pytest_plugins
  • pytest_mark
  • PYTEST_DONT_REWRITE(模块文档字符串)
• 环境变量(Environment Variables)
  • PYTEST_ADDOPTS
  • PYTEST_DEBUG
  • PYTEST_PLUGINS
  • PYTEST_DISABLE_PLUGIN_AUTOLOAD
  • PYTEST_CURRENT_TEST
• 异常(Exceptions)
  • UsageError

返回: Pytest权威教程

特殊变量(Special Variables)

pytest在测试模块中定义时以特殊方式处理一些全局变量。

collect_ignore

参考: 自定义测试集合

可以在conftest.py文件中声明以排除测试目录或模块。需要成为list[str]。

collect_ignore = ["setup.py"]

collect_ignore_glob

参考: 自定义测试集合

可以在conftest.py文件中声明,以使用Unix shell样式的通配符排除测试目录或模块。需要在list[str]哪里str可以包含glob模式。

collect_ignore_glob = ["*_ignore.py"]

pytest_plugins

参考: 在测试模块或conftest文件中要求/加载插件

可以在测试模块和conftest.py文件中在全局级别声明以注册其他插件。可以是一个或。str``Sequence[str]

pytest_plugins = "myapp.testsupport.myplugin"

pytest_plugins = ("myapp.testsupport.tools","myapp.testsupport.regression")

pytest_mark

参考: 标记整个类或模块

可以在测试模块的全局级别声明,以将一个或多个[标记

import pytest

pytestmark = pytest.mark.webtest

import pytest

pytestmark = [pytest.mark.integration,pytest.mark.slow]

PYTEST_DONT_REWRITE(模块文档字符串)

PYTEST_DONT_REWRITE可以将文本添加到任何模块docstring以禁用该模块的断言重写。

环境变量(Environment Variables)

可用于更改pytest行为的环境变量。

PYTEST_ADDOPTS

它包含一个命令行(由py：mod：shlex模块解析),该命令行将添加到用户给出的命令行之前,有关详细信息,请参阅如何更改命令行选项默认值。

PYTEST_DEBUG

设置后,pytest将打印跟踪和调试信息。

PYTEST_PLUGINS

包含应作为插件加载的以逗号分隔的模块列表：

export PYTEST_PLUGINS=mymodule.plugin,xdist

PYTEST_DISABLE_PLUGIN_AUTOLOAD

设置后,通过setuptools入口点禁用插件自动加载。只会加载明确指定的插件。

PYTEST_CURRENT_TEST

这并不是由用户设置,而是由pytest在内部设置当前测试的名称,以便其他进程可以检查它,有关详细信息,请参阅PYTEST_CURRENT_TEST环境变量。

异常(Exceptions)

UsageError

class UsageError[source]
    error in pytest usage or invocation