目录
- 配置
- 命令行选项和配置文件设置
- 初始化:确定ROOTDIR和INIFILE
- 寻找rootdir
- 如何更改命令行选项默认值
- 内置的配置文件选项
配置
命令行选项和配置文件设置
你可以使用常规帮助选项获取有关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。
内置的配置文件选项
有关选项的完整列表,请参考参考文档。
原文地址:https://www.cnblogs.com/superhin/p/11741587.html