diff options
| author | Hugo van Kemenade <hugovk@users.noreply.github.com> | 2022-07-25 16:24:42 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-07-25 16:24:42 (GMT) |
| commit | 10b12dd92ab6e29b573706dd6adb3d8eb63ae81b (patch) | |
| tree | 94327e9635401ec6d69d7186037a95b2b88e55dc | |
| parent | ccd7c7a0bde2587ee0e1e685f4651b50d90bd464 (diff) | |
| download | cpython-10b12dd92ab6e29b573706dd6adb3d8eb63ae81b.zip cpython-10b12dd92ab6e29b573706dd6adb3d8eb63ae81b.tar.gz cpython-10b12dd92ab6e29b573706dd6adb3d8eb63ae81b.tar.bz2 | |
gh-93963: Document importlib.abc deprecations (#94546)
| -rw-r--r-- | Doc/library/importlib.resources.abc.rst | 9 | ||||
| -rw-r--r-- | Doc/whatsnew/3.12.rst | 18 |
2 files changed, 27 insertions, 0 deletions
diff --git a/Doc/library/importlib.resources.abc.rst b/Doc/library/importlib.resources.abc.rst index d281ac0..57fffe0 100644 --- a/Doc/library/importlib.resources.abc.rst +++ b/Doc/library/importlib.resources.abc.rst @@ -45,6 +45,9 @@ .. versionadded:: 3.7 + .. deprecated-removed:: 3.12 3.14 + Use :class:`importlib.resources.abc.TraversableResources` instead. + .. abstractmethod:: open_resource(resource) Returns an opened, :term:`file-like object` for binary reading @@ -91,6 +94,9 @@ .. versionadded:: 3.9 + .. deprecated-removed:: 3.12 3.14 + Use :class:`importlib.resources.abc.Traversable` instead. + .. attribute:: name Abstract. The base name of this object without any parent references. @@ -146,6 +152,9 @@ .. versionadded:: 3.9 + .. deprecated-removed:: 3.12 3.14 + Use :class:`importlib.resources.abc.TraversableResources` instead. + .. abstractmethod:: files() Returns a :class:`importlib.resources.abc.Traversable` object for the loaded diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst index 4a37e28..0302055 100644 --- a/Doc/whatsnew/3.12.rst +++ b/Doc/whatsnew/3.12.rst @@ -180,6 +180,24 @@ APIs: * :func:`unittest.getTestCaseNames` (:gh:`50096`) * :class:`webbrowser.MacOSX` (:gh:`86421`) +Pending Removal in Python 3.14 +============================== + +* Deprecated the following :mod:`importlib.abc` classes, scheduled for removal in + Python 3.14: + + * :class:`importlib.abc.ResourceReader` + * :class:`importlib.abc.Traversable` + * :class:`importlib.abc.TraversableResources` + + Use :mod:`importlib.resources.abc` classes instead: + + * :class:`importlib.resources.abc.TraversableResources` + * :class:`importlib.resources.abc.Traversable` + * :class:`importlib.resources.abc.TraversableResources` + + (Contributed by Jason R. Coombs and Hugo van Kemenade in :gh:`93963`.) + Pending Removal in Future Versions ---------------------------------- |