Merge pull request #10357 from pytest-dev/backport-10331-to-7.1.x

[7.1.x] Add note in documentation to help modernize code bases to use pathlib
This commit is contained in:
Bruno Oliveira 2022-10-08 10:36:18 -03:00 committed by GitHub
commit 0cd2867872
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 0 deletions

View File

@ -109,6 +109,17 @@ rather than standard :class:`pathlib.Path` objects.
.. note::
These days, it is preferred to use ``tmp_path`` and ``tmp_path_factory``.
In order to help modernize old code bases, one can run pytest with the legacypath
plugin disabled:
.. code-block:: bash
pytest -p no:legacypath
This will trigger errors on tests using the legacy paths.
It can also be permanently set as part of the :confval:`addopts` parameter in the
config file.
See :fixture:`tmpdir <tmpdir>` :fixture:`tmpdir_factory <tmpdir_factory>`
API for details.