Pytest权威教程25-配置

配置

返回: Pytest权威教程

配置

命令行选项和配置文件设置

你可以使用常规帮助选项获取有关INI选项配置文件中命令行选项和值的帮助：

pytest -h   # prints options _and_ config file settings

这将显示已安装插件注册的命令行和配置文件设置。

初始化：确定ROOTDIR和INIFILE

pytest根据rootdir命令行参数（指定的测试文件，路径）以及ini-files的存在为每次测试运行确定一个。在启动过程中，确定的文件rootdir和ini文件将作为pytest标头的一部分打印。

以下是摘要的pytest用途rootdir：

在收集期间构造nodeid；每个测试都分配有一个唯一的nodeid，该id植根于，rootdir并考虑了完整路径，类名，函数名和参数化（如果有）。
插件将其用作存储项目/测试运行特定信息的稳定位置；例如，内部缓存插件在其中创建一个.pytest_cache子目录rootdir来存储其交叉测试运行状态。

需要特别强调的是，rootdir它不用于修改sys.path/PYTHONPATH或影响模块的导入方式。有关更多详细信息，请参见：Pytest导入机制和系统路径。

--rootdir=path命令行选项可用于强制使用特定目录。可以配合使用在pytest.ini文件中的addopts项中添加该参数来包含特定目录到环境变量中。

寻找rootdir

这是从中找到rootdir的算法args：

确定指定的公共祖先目录，这些目录args被识别为文件系统中存在的路径。如果找不到此类路径，则将公共祖先目录设置为当前工作目录。
寻找pytest.ini，tox.ini并setup.cfg在父目录和文件向上。如果匹配，它将成为ini文件，并且其目录将成为rootdir。
如果未找到ini文件，请setup.py从公共祖先目录向上查找以确定rootdir。
如果没有setup.py被发现，寻找pytest.ini，tox.ini并 setup.cfg在每个指定args向上。如果匹配，它将成为ini文件，并且其目录将成为rootdir。
如果找不到ini文件，则使用已经确定的公共祖先作为根目录。这允许在不属于包且没有任何特定ini文件配置的结构中使用pytest。
如果没有args给出，pytest会在当前工作目录下收集测试，并从那里开始确定rootdir。

注意：自定义pytest plugin命令行参数可能包含路径，如中所示。然后是强制性的，否则pytest使用test.log文件夹确定rootdir（另请参见问题1435）。也可以使用点来引用当前工作目录。pytest --log-output ../../test.log argsargs.

请注意，现有的pytest.ini文件将始终被认为是匹配的，而tox.ini且setup.cfg只会如果包含匹配 [pytest]或[tool:pytest]部分，分别。多个ini-file候选文件中的选项永远不会合并-第一个获胜（pytest.ini即使不包含任何[pytest]部分，也总是成功）。

该config对象随后将具有以下属性：

config.rootdir：确定的根目录，保证存在。
config.inifile：确定的ini文件可能是None。

rootdir用作构建测试地址（“ nodeids”）的参考目录，也可以由插件用于存储每次测试运行信息。

例如：

pytest path/to/testdir path/other/

将确定共同祖先path，然后检查ini文件，如下所示：

# first look for pytest.ini files

path/pytest.ini

path/tox.ini    # must also contain [pytest] section to match

path/setup.cfg  # must also contain [tool:pytest] section to match

pytest.ini

... # all the way down to the root

# now look for setup.py

path/setup.py

setup.py

... # all the way down to the root

如何更改命令行选项默认值

每次使用时，键入相同系列的命令行选项可能很麻烦pytest。例如，如果您始终希望查看有关跳过的测试和xfailed测试的详细信息，以及具有简短的“点”进度输出，则可以将其写入配置文件：

# content of pytest.ini or tox.ini

[pytest]

addopts = -ra -q

# content of setup.cfg

[tool:pytest]

addopts = -ra -q

另外，您可以设置PYTEST_ADDOPTS环境变量以在使用环境时添加命令行选项：

export PYTEST_ADDOPTS="-v"

这是在addopts或环境变量存在的情况下构建命令行的方式：

<pytest.ini:addopts> $PYTEST_ADDOPTS <extra command-line arguments>

因此，如果用户在命令行中执行：

pytest -m slow

执行的实际命令行为：

pytest -ra -q -v -m slow

请注意，与其他命令行应用程序一样，在选项冲突的情况下，最后一个将获胜，因此上面的示例将显示冗长的输出，因为-voverwrites -q。

内置的配置文件选项

有关选项的完整列表，请参考参考文档。