安装和使用插件¶
本节讨论安装和使用第三方插件。要编写自己的插件,请参阅 编写插件 .
安装第三方插件很容易 pip
:
pip install pytest-NAME
pip uninstall pytest-NAME
如果安装了插件, pytest
自动查找和集成它,不需要激活它。
下面是一些流行插件的注释列表:
pytest-django: 编写测试 django 应用程序,使用pytest集成。
pytest-twisted: 编写测试 twisted 应用程序,启动一个反应器,处理测试功能的延迟。
pytest-cov :覆盖率报告,与分布式测试兼容
pytest-xdist: 要将测试分发到CPU和远程主机,要在允许分段错误存活的盒装模式下运行,要在循环失败模式下运行,要自动对文件更改重新运行失败的测试。
pytest-instafail: 在测试运行期间报告失败。
pytest-bdd: 使用行为驱动测试编写测试。
pytest-timeout: 根据函数标记或全局定义使测试超时。
pytest-pep8: 一
--pep8
启用PEP8合规性检查的选项。pytest-flakes: 用pyflakes检查源代码。
oejskit: 在实时浏览器中运行javascript单元测试的插件。
要查看针对不同pytest和python版本的所有插件的最新测试状态的完整列表,请访问 plugincompat .
您还可以通过 pytest- pypi.org search .
在测试模块或conftest文件中要求/加载插件¶
您可以使用 pytest_plugins
:
pytest_plugins = ("myapp.testsupport.myplugin",)
当加载测试模块或ConfTest插件时,也将加载指定的插件。
注解
要求插件使用 pytest_plugins
非根变量 conftest.py
文件已弃用。见 full explanation 在编写插件部分。
注解
名字 pytest_plugins
是保留的,不应用作自定义插件模块的名称。
找出哪些插件处于活动状态¶
如果您想知道哪些插件在您的环境中处于活动状态,可以键入:
pytest --trace-config
将得到一个扩展的测试头,显示激活的插件及其名称。它还将打印本地插件aka conftest.py 文件加载时。
按名称停用/注销插件¶
您可以阻止插件加载或注销它们:
pytest -p no:NAME
这意味着任何后续的激活/加载命名插件的尝试都将不起作用。
如果要无条件禁用项目的插件,可以将此选项添加到 pytest.ini
文件:
[pytest]
addopts = -p no:NAME
或者,要仅在某些环境(例如在CI服务器中)禁用它,可以设置 PYTEST_ADDOPTS
环境变量到 -p no:name
.
见 找出哪些插件处于活动状态 如何获取插件的名称。