mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-08 13:42:22 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

gh-93963: Document importlib.abc deprecations (#94546)

Browse source
This commit is contained in:
Hugo van Kemenade 2022-07-25 19:24:42 +03:00 • committed by GitHub
parent ccd7c7a0bd
commit 10b12dd92a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 27 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/library/importlib.resources.abc.rst
View file

@ -45,6 +45,9 @@
.. versionadded:: 3.7 .. versionadded:: 3.7
.. deprecated-removed:: 3.12 3.14
Use :class:`importlib.resources.abc.TraversableResources` instead.
.. abstractmethod:: open_resource(resource) .. abstractmethod:: open_resource(resource)
Returns an opened, :term:`file-like object` for binary reading Returns an opened, :term:`file-like object` for binary reading
@ -91,6 +94,9 @@
.. versionadded:: 3.9 .. versionadded:: 3.9
.. deprecated-removed:: 3.12 3.14
Use :class:`importlib.resources.abc.Traversable` instead.
.. attribute:: name .. attribute:: name
Abstract. The base name of this object without any parent references. Abstract. The base name of this object without any parent references.
@ -146,6 +152,9 @@
.. versionadded:: 3.9 .. versionadded:: 3.9
.. deprecated-removed:: 3.12 3.14
Use :class:`importlib.resources.abc.TraversableResources` instead.
.. abstractmethod:: files() .. abstractmethod:: files()
Returns a :class:`importlib.resources.abc.Traversable` object for the loaded Returns a :class:`importlib.resources.abc.Traversable` object for the loaded

18
Doc/whatsnew/3.12.rst
View file

@ -180,6 +180,24 @@ APIs:
* :func:`unittest.getTestCaseNames` (:gh:`50096`) * :func:`unittest.getTestCaseNames` (:gh:`50096`)
* :class:`webbrowser.MacOSX` (:gh:`86421`) * :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 Pending Removal in Future Versions
---------------------------------- ----------------------------------