diff --git a/changelog/7259.deprecation.rst b/changelog/7259.deprecation.rst index 0668efdf9b3..f9f5a662946 100644 --- a/changelog/7259.deprecation.rst +++ b/changelog/7259.deprecation.rst @@ -5,3 +5,6 @@ .. note:: The name of the ``Node`` arguments and attributes (old ``fspath``, new ``path``) is **the opposite** of the situation for hooks (old ``path``, new ``fspath``). + This is an unfortunate artifact due to historical reasons, which should be + resolved in future versions as we slowly get rid of the :pypi:`py` + dependency (see :issue:`9283` for a longer discussion). diff --git a/changelog/8144.feature.rst b/changelog/8144.feature.rst index cee8fed8863..77340916c09 100644 --- a/changelog/8144.feature.rst +++ b/changelog/8144.feature.rst @@ -9,3 +9,6 @@ The following hooks now receive an additional ``pathlib.Path`` argument, equival .. note:: The name of the ``Node`` arguments and attributes (old ``fspath``, new ``path``) is **the opposite** of the situation for hooks (old ``path``, new ``fspath``). + This is an unfortunate artifact due to historical reasons, which should be + resolved in future versions as we slowly get rid of the :pypi:`py` + dependency (see :issue:`9283` for a longer discussion). diff --git a/changelog/8251.feature.rst b/changelog/8251.feature.rst index c6c677c9677..f4fbf5b5da5 100644 --- a/changelog/8251.feature.rst +++ b/changelog/8251.feature.rst @@ -4,3 +4,6 @@ due to the ongoing migration of methods like :meth:`~_pytest.Item.reportinfo`, w .. note:: The name of the attributes (old ``fspath``, new ``path``) is **the opposite** of the situation for hooks. + This is an unfortunate artifact due to historical reasons, which should be + resolved in future versions as we slowly get rid of the :pypi:`py` + dependency (see :issue:`9283` for a longer discussion). diff --git a/doc/en/deprecations.rst b/doc/en/deprecations.rst index c2e27678dde..51165389618 100644 --- a/doc/en/deprecations.rst +++ b/doc/en/deprecations.rst @@ -59,6 +59,9 @@ Plugins which implement custom items and collectors are encouraged to replace .. note:: The name of the arguments (old ``fspath``, new ``path``) is **the opposite** of the situation for hooks, :ref:`outlined below `. + This is an unfortunate artifact due to historical reasons, which should be + resolved in future versions as we slowly get rid of the :pypi:`py` + dependency (see :issue:`9283` for a longer discussion). Due to the ongoing migration of methods like :meth:`~_pytest.Item.reportinfo` which still is expected to return a ``py.path.local`` object, nodes still have @@ -86,6 +89,9 @@ The accompanying ``py.path.local`` based paths have been deprecated: plugins whi .. note:: The name of the arguments (old ``path``, new ``fspath``) is **the opposite** of the situation for the :class:`~_pytest.nodes.Node` class, :ref:`outlined above `. + This is an unfortunate artifact due to historical reasons, which should be + resolved in future versions as we slowly get rid of the :pypi:`py` + dependency (see :issue:`9283` for a longer discussion). Directly constructing internal classes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~