floraachy
/
pytest2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #10549 from yusuke-kadowaki/more_doc_update 

Documentation update for the tmp_path configurations
This commit is contained in:
Bruno Oliveira 2022-12-01 12:23:43 -03:00 committed by GitHub
parent fd30759d94 62e75c7d55
commit 314e623304
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
doc/en/how-to/tmp_path.rst
View File

@ -131,10 +131,13 @@ The default base temporary directory
Temporary directories are by default created as sub-directories of Temporary directories are by default created as sub-directories of
the system temporary directory. The base name will be ``pytest-NUM`` where the system temporary directory. The base name will be ``pytest-NUM`` where
``NUM`` will be incremented with each test run. Moreover, entries older ``NUM`` will be incremented with each test run.
than 3 temporary directories will be removed. By default, only the directories of failed tests will be kept.
Also only the last 3 directries will remain at most.
This behavior can be configured with :confval:`tmp_path_retention_count` and
:confval:`tmp_path_retention_policy`.
The number of entries currently cannot be changed, but using the ``--basetemp`` Using the ``--basetemp``
option will remove the directory before every run, effectively meaning the temporary directories option will remove the directory before every run, effectively meaning the temporary directories
of only the most recent run will be kept. of only the most recent run will be kept.

6
src/_pytest/tmpdir.py
View File

@ -267,8 +267,10 @@ def tmp_path(
directory. directory.
By default, a new base temporary directory is created each test session, By default, a new base temporary directory is created each test session,
and old bases are removed after 3 sessions, to aid in debugging. If and only the base of failed session is kept. Also it only keeps the last 3 bases
``--basetemp`` is used then it is cleared each session. See :ref:`base at most. This can be configured with :confval:`tmp_path_retention_count` and
:confval:`tmp_path_retention_policy`.
If ``--basetemp`` is used then it is cleared each session. See :ref:`base
temporary directory`. temporary directory`.
The returned object is a :class:`pathlib.Path` object. The returned object is a :class:`pathlib.Path` object.