Skip to content

Commit 799dab9

Browse files
authored
Documentation update for rootdir discovery
This covers issue pytest-dev#1435.
1 parent 3e685d6 commit 799dab9

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

doc/en/customize.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,16 @@ Here is the algorithm which finds the rootdir from ``args``:
4848
directory. This allows to work with pytest in structures that are not part of
4949
a package and don't have any particular ini-file configuration.
5050

51+
If no ``args`` are given, pytest collects test below the current working
52+
directory and also starts determining the rootdir from there.
53+
54+
:warning: custom pytest plugin commandline arguments may include a path, as in
55+
``py.test --log-output ../../test.log args``. Then ``args`` is mandatory,
56+
otherwise pytest uses the folder of test.log for rootdir determination
57+
(see also `issue 1435 <https://github.com/pytest-dev/pytest/issues/1435>`_).
58+
A dot ``.`` for referencing to the current working directory is also
59+
possible.
60+
5161
Note that an existing ``pytest.ini`` file will always be considered a match,
5262
whereas ``tox.ini`` and ``setup.cfg`` will only match if they contain a
5363
``[pytest]`` section. Options from multiple ini-files candidates are never

0 commit comments

Comments
 (0)