如何调用 pytest¶
另请参见
通常，使用命令 pytest 调用 pytest（请参阅下文以了解 其他调用 pytest 的方法）。这将在当前目录及其子目录中执行所有名称遵循 test_*.py 或 \*_test.py 形式的所有文件中的所有测试。更一般地说，pytest 遵循 标准测试发现规则。
指定要运行哪些测试¶
Pytest 支持从命令行或文件中运行和选择测试的多种方法（请参阅下文以了解 从文件中读取参数）。
在模块中运行测试
pytest test_mod.py
在目录中运行测试
pytest testing/
按关键字表达式运行测试
pytest -k 'MyClass and not method'
这将运行包含与给定的字符串表达式（不区分大小写）匹配的名称的测试，其中可以包括使用文件名、类名和函数名作为变量的 Python 运算符。上面的示例将运行 TestMyClass.test_something 但不会运行 TestMyClass.test_method_simple。在 Windows 上运行此命令时，请在表达式中使用 "" 而不是 ''
按收集参数运行测试
传递相对于工作目录的模块文件名，后跟使用 :: 字符分隔的类名和函数名等说明符，以及用 [] 括起来的来自参数化的参数。
要在模块中运行特定测试
pytest tests/test_mod.py::test_func
要在类中运行所有测试
pytest tests/test_mod.py::TestClass
指定特定测试方法
pytest tests/test_mod.py::TestClass::test_method
指定测试的特定参数化
pytest tests/test_mod.py::test_func[x1,y2]
按标记表达式运行测试
pytest -m slow
将运行用 @pytest.mark.slow 装饰器装饰的所有测试。
有关更多信息，请参阅 标记。
从包中运行测试
pytest --pyargs pkg.testing
这将导入 pkg.testing 并使用其文件系统位置来查找和运行测试。
从文件中读取参数
在 8.2 版中添加。
可以使用 @ 前缀从文件中读取上述所有内容
pytest @tests_to_run.txt
其中 tests_to_run.txt 每行包含一个条目，例如：
tests/test_file.py
tests/test_mod.py::test_func[x1,y2]
tests/test_mod.py::TestClass
-m slow
还可以使用 pytest --collect-only -q 生成此文件，并根据需要进行修改。
获取有关版本、选项名称、环境变量的帮助¶
pytest --version # shows where pytest was imported from
pytest --fixtures # show available builtin function arguments
pytest -h | --help # show help on command line and config file options
分析测试执行持续时间¶
在 6.0 版中更改。
要获取超过 1.0 秒的 10 个最慢测试持续时间列表
pytest --durations=10 --durations-min=1.0
默认情况下，pytest 不会显示太小的测试持续时间（<0.005 秒），除非在命令行中传递 -vv。
管理插件加载¶
早期加载插件¶
您可以使用 -p 选项在命令行中明确早期加载插件（内部和外部）。
pytest -p mypluginmodule
该选项接收一个 name 参数，该参数可以是
一个完整的模块点号名称，例如
myproject.plugins。此点号名称必须可导入。插件的入口点名称。这是在注册插件时传递给
setuptools的名称。例如，要早期加载 pytest-cov 插件，可以使用pytest -p pytest_cov
禁用插件¶
要在调用时禁用加载特定插件，请将 -p 选项与前缀 no: 一起使用。
示例：要禁用加载插件 doctest（负责从文本文件中执行 doctest 测试），请像这样调用 pytest
pytest -p no:doctest
其他调用 pytest 的方法¶
通过 python -m pytest 调用 pytest¶
您可以通过命令行中的 Python 解释器调用测试
python -m pytest [...]
这几乎等同于直接调用命令行脚本 pytest [...]，除了通过 python 调用还会将当前目录添加到 sys.path 中。
从 Python 代码调用 pytest¶
您可以直接从 Python 代码调用 pytest
retcode = pytest.main()
这相当于从命令行调用“pytest”。它不会引发 SystemExit，而是返回 退出代码。如果您没有传递任何参数，main 会从进程的命令行参数（sys.argv）中读取参数，这可能不理想。您可以明确传递选项和参数
retcode = pytest.main(["-x", "mytestdir"])
您可以为 pytest.main 指定其他插件
# content of myinvoke.py
import sys
import pytest
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()（例如，为了重新运行测试）。
