调用执行测试-如何调用pytest
目录
通常,使用命令调用 pytest(有关调用 pytest 的其他方法,pytest请参见下文)。这将在名称遵循表单的所有文件中或 在当前目录及其子目录中执行所有测试。更一般地说,pytest 遵循标准测试发现规则。test_*.py*_test.py
完整的 pytest 命令行标志参考,pytest支持多种命令行运行的方法
按照目录执行测试(运行某个文件夹下的用例)
pytest testing/
按照模块执行测试(运行某个py文件)
pytest test_mod.py
通过关键字表达式执行测试
- 这将运行包含与给定字符串表达式匹配的名称(不区分大小写)的测试,其中可以包括使用文件名、类名和函数名作为变量的 Python 运算符。上面的例子会运行
TestMyClass.test_something
,但不会TestMyClass.test_method_simple
。
pytest -k "MyClass and not method"
按照节点执行用例
- 每个收集到的测试都被分配一个唯一的nodeid,它由模块文件名和后面的说明符组成,如类名、函数名和参数化的参数,用
::
字符分隔。 - 要在模块中运行特定测试:
pytest test_mod.py::test_func
pytest test_mod.py::TestClass::test_method
通过标记表达式运行测试
- 将运行所有用
@pytest.mark.slow
装饰器装饰的测试。 - 有关详细信息,请参阅标记。
pytest -m slow
按照包执行测试
- 这将导入pkg.testing并使用其文件系统位置来查找和运行测试。
pytest --pyargs pkg.testing
分析测试执行持续时间
- 默认情况下,pytest 不会显示太小(<0.005s)的测试持续时间,除非-vv在命令行上传递。
- 要获得超过 1.0 秒的最慢 10 个测试持续时间的列表:
pytest --durations=10 --durations-min=1.0
管理插件的加载
早期加载插件
- -p您可以使用以下选项在命令行中显式地提前加载插件(内部和外部) :
pytest -p mypluginmodule
该选项接收一个name参数,可以是:
-
完整的模块名称,例如myproject.plugins. 这个带点的名称必须是可导入的。
-
插件的入口点名称。setuptools这是插件注册时传递给的名称。例如,要提前加载pytest-cov插件,您可以使用:
pytest -p pytest_cov
禁用插件
-
要在调用时禁用加载特定插件,请将该
-p
选项与前缀一起使用no:
。 -
示例:要禁用加载
doctest
负责从文本文件执行 doctest 测试的插件,请像这样调用 pytest:
pytest -p no:doctest
调用 pytest 的其他方式
- 这几乎等同于 直接调用命令行脚本,只是调用 via还会将当前目录添加到.pytest [...]pythonsys.path
- 您可以从命令行通过 Python 解释器调用测试:
python -m pytest [...]
从 Python 代码调用 pytest
-
pytest
您可以直接从 Python 代码调用:retcode = pytest.main()
-
这就像您从命令行调用“pytest”一样。它不会引发SystemExit而是返回退出代码。您可以传入选项和参数:
retcode = pytest.main(["-x", "mytestdir"])
-
您可以指定其他插件
pytest.main
:# content of myinvoke.py import pytest import sys class MyPlugin: def pytest_sessionfinish(self): print("*** test run reporting finishing") if __name__ == "__main__": sys.exit(pytest.main(["-qq"], plugins=[MyPlugin()]))
运行它将显示MyPlugin
已添加并调用了它的钩子:
$ python myinvoke.py
*** test run reporting finishing
调用
pytest.main()
将导致导入您的测试和它们导入的任何模块。由于 python 导入系统的缓存机制,pytest.main()
从同一进程进行后续调用不会反映调用之间对这些文件的更改。因此,pytest.main()
不建议从同一进程多次调用(例如,为了重新运行测试)。