diff options
| author | Brett Cannon <brett@python.org> | 2024-09-23 21:14:33 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-09-23 21:14:33 (GMT) |
| commit | 67201ad53ff11576c69a9b762540b77128285f8d (patch) | |
| tree | c9b5cfe3cb1de03d618060d4ec0c343a2fe10a12 /Doc | |
| parent | 41e7992e319faba91b0c75a767b36ff8628a8368 (diff) | |
| download | cpython-67201ad53ff11576c69a9b762540b77128285f8d.zip cpython-67201ad53ff11576c69a9b762540b77128285f8d.tar.gz cpython-67201ad53ff11576c69a9b762540b77128285f8d.tar.bz2 | |
GH-65961: Document the deprecation of `__package__` and `__cached__` (GH-124377)
The code changes for warning related to `__package__` landed in Python 3.12. `__cached__` doesn't have any changes as it isn't used but only set by the import system.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/deprecations/pending-removal-in-3.14.rst | 3 | ||||
| -rw-r--r-- | Doc/deprecations/pending-removal-in-3.15.rst | 3 | ||||
| -rw-r--r-- | Doc/library/importlib.rst | 4 | ||||
| -rw-r--r-- | Doc/reference/import.rst | 8 |
4 files changed, 13 insertions, 5 deletions
diff --git a/Doc/deprecations/pending-removal-in-3.14.rst b/Doc/deprecations/pending-removal-in-3.14.rst index 6c831ae..452d664 100644 --- a/Doc/deprecations/pending-removal-in-3.14.rst +++ b/Doc/deprecations/pending-removal-in-3.14.rst @@ -47,9 +47,6 @@ Pending Removal in Python 3.14 * :mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils.localtime`. (Contributed by Alan Williams in :gh:`72346`.) -* :mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or - taken into consideration by the import system (:gh:`97879`). - * :mod:`importlib.abc` deprecated classes: * :class:`!importlib.abc.ResourceReader` diff --git a/Doc/deprecations/pending-removal-in-3.15.rst b/Doc/deprecations/pending-removal-in-3.15.rst index f7145a8..b921b4f 100644 --- a/Doc/deprecations/pending-removal-in-3.15.rst +++ b/Doc/deprecations/pending-removal-in-3.15.rst @@ -17,6 +17,9 @@ Pending Removal in Python 3.15 * The :option:`!--cgi` flag to the :program:`python -m http.server` command-line interface has been deprecated since Python 3.13. +* :mod:`importlib`: ``__package__`` and ``__cached__`` will cease to be set or + taken into consideration by the import system (:gh:`97879`). + * :class:`locale`: * The :func:`~locale.getdefaultlocale` function diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst index d0a3d9d..e4cef1f 100644 --- a/Doc/library/importlib.rst +++ b/Doc/library/importlib.rst @@ -1237,8 +1237,8 @@ find and load modules. .. attribute:: has_location ``True`` if the spec's :attr:`origin` refers to a loadable location, - ``False`` otherwise. This value impacts how :attr:`origin` is interpreted - and how the module's :attr:`__file__` is populated. + ``False`` otherwise. This value impacts how :attr:`origin` is interpreted + and how the module's :attr:`__file__` is populated. .. class:: AppleFrameworkLoader(name, path) diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst index 7de995b..19b8aa0 100644 --- a/Doc/reference/import.rst +++ b/Doc/reference/import.rst @@ -596,6 +596,10 @@ listed below. Raise :exc:`DeprecationWarning` instead of :exc:`ImportWarning` when falling back to ``__package__``. + .. deprecated-removed:: 3.13 3.15 + ``__package__`` will cease to be set or taken into consideration + by the import system or standard library. + .. attribute:: __spec__ @@ -653,6 +657,10 @@ listed below. It is **strongly** recommended that you rely on :attr:`__spec__` instead of ``__cached__``. + .. deprecated-removed:: 3.13 3.15 + ``__cached__`` will cease to be set or taken into consideration + by the import system or standard library. + .. _package-path-rules: module.__path__ |