【pytest官方文档】解读- 如何安装和使用插件

时间:2022-09-26 14:56:48

本节讨论安装和使用第三方插件。关于编写自己的插件,我们下一章继续。

一、pip 安装

就像安装一些其他第三方库一样,使用pip也可以很容易地安装第三方插件,pytest-NAME这是你要安装的插件名称:

# 安装
pip install pytest-NAME

#卸载
pip uninstall pytest-NAME

比如我这里安装一个pytest-xdist的插件:

【pytest官方文档】解读- 如何安装和使用插件

第三方插件装完就可以直接用了,pytest会自动找到并集成它,不需要我们手动激活它。

二、查找可用插件

pytest的第三方插件非常丰富,所以功能也是多种多样的。下面列举一些流行的插件:

  • pytest-django: 为django应用程序编写测试,使用pytest集成。
  • pytest-cov: 覆盖报告,兼容分布式测试
  • pytest-xdist: 将测试分发到cpu和远程主机,提高执行效率
  • pytest-instafail: 在测试运行时报告失败
  • pytest-bdd: 使用行为驱动测试编写测试用例
  • pytest-timeout: 根据函数标记或全局定义测试超时。
  • pytest-pep8: 启用pep8合规性检查
    ...

官方有一个完整插件列表,里面有针对不同pytestPython版本的最新测试状态,传送门 在此。

此外,我们也可以在pytest- pypi.org search搜索插件。

插件非常多,后续遇到一些很实用或者很有趣的插件会单独进行分享。上面关于pytest-xdist分布式执行的插件之前有过介绍,都添加到文章末尾的pytest合集里了,有需要的自取。

三、在测试模块或者conftest文件中加载指定插件

我们可以使用pytest_plugins在测试模块或conftest文件中加载指定插件:

# 可以是单个插件,就是一个字符串
pytest_plugins = "myapp.testsupport.myplugin"

# 也可以加载多个,字符串的队列
pytest_plugins = ("myapp.testsupport.tools", "myapp.testsupport.regression")

当测试模块或conftest插件被加载时,指定的插件也会被加载。

值得注意的是:

  • 尽量不要在非根目录的conftest.py文件中使用pytest_plugins变量来加载插件(开发插件时候继续展开)
  • 自定义插件模块的名称不要使用pytest_plugins来命名

四、查看被激活的插件

如果想知道哪些插件在本地环境中是激活的,可以通过该命令:

pytest --trace-config

在测试头部信息中会显示激活的插件,它还会在加载本地插件时打印出conftest.py文件

【pytest官方文档】解读- 如何安装和使用插件

五、注销插件

我们可以阻止插件加载或注销它们:

pytest -p no:NAME

这样,后续就没办法进行插件的激活/加载了。

如果想无条件地禁用一个项目的插件,可以在项目配置文件pytest.ini中添加这个选项即可:

[pytest]
addopts = -p no:NAME

文末附上合集的传送门

pytest合集见链接