1.如何调用pytest

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

1.1.指定要运行的测试

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

在module运行测试

pytest test_mod.py

在目录运行测试

pytest testing/

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

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

pytest -k "MyClass and not method"

通过node ids运行测试

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

pytest test_mod.py::test_func

另一个运行指定测试的例子

pytest test_mod.py::TestClass::test_method

通过marker expressions运行测试

pytest -m slow

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

从包运行测试

pytest --pyargs pkg.testing

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

1.2.获取版本、选项、名字、环境变量帮助

pytest --version #获取版本
pytest --fixtures #显示可用的内置功能参数
pytest -h | --help #获取帮助

1.3.分析测试执行持续时间

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

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

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

1.4.管理插件的加载

1.4.1.早期加载插件

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

pytest -p mypluginmodule

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

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

  pytest -p pytest_cov
  

1.4.2.禁用插件

要在调用时禁用加载特定插件，请使用-p选项和前缀no:
示例：要禁用加载插件doctest，该插件负责从文本文件执行doctest测试，请像这样调用pytest：

pytest -p no:doctest

1.5.其他方法调用pytest

1.5.1.通过python -m pytest

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

python -m pytest [...]

这几乎等同于直接调用命令行脚本pytest […]，只是通过python调用还会将当前目录添加到sys.path中。

1.5.2.通过Python代码

可以直接通过Python代码调用pytest

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()（例如，为了重新运行测试）。