From 7d76b884c09012fd1b6e90d6444acb7bb0b4e3e8 Mon Sep 17 00:00:00 2001
From: Tomas R <tomas.roun8@gmail.com>
Date: Tue, 11 Feb 2025 20:04:16 +0100
Subject: [PATCH] gh-97850: Update the deprecation warning of
`importlib.abc.Loader.load_module` (GH-129855) (cherry picked from commit
aa81a6f6e4f265565da9781d0bf95c7d16ddd961)
Co-authored-by: Tomas R. <tomas.roun8@gmail.com>
---
Doc/deprecations/pending-removal-in-3.15.rst | 4 ++++
Doc/deprecations/pending-removal-in-future.rst | 1 -
Doc/library/importlib.rst | 12 ++++++------
Lib/importlib/_bootstrap.py | 2 +-
.../2025-02-08-15-13-43.gh-issue-97850.jQ0CvW.rst | 2 ++
5 files changed, 13 insertions(+), 8 deletions(-)
create mode 100644 Misc/NEWS.d/next/Library/2025-02-08-15-13-43.gh-issue-97850.jQ0CvW.rst
diff --git a/Doc/deprecations/pending-removal-in-3.15.rst b/Doc/deprecations/pending-removal-in-3.15.rst
index f0b184b6c804cd..7e63567ce2ec0f 100644
--- a/Doc/deprecations/pending-removal-in-3.15.rst
+++ b/Doc/deprecations/pending-removal-in-3.15.rst
@@ -29,6 +29,10 @@ 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`:
+
+ * ``load_module()`` method: use ``exec_module()`` instead.
+
* :class:`locale`:
* The :func:`~locale.getdefaultlocale` function
diff --git a/Doc/deprecations/pending-removal-in-future.rst b/Doc/deprecations/pending-removal-in-future.rst
index 3f9cf6f208221a..fdca65c341209d 100644
--- a/Doc/deprecations/pending-removal-in-future.rst
+++ b/Doc/deprecations/pending-removal-in-future.rst
@@ -57,7 +57,6 @@ although there is currently no date scheduled for their removal.
* :mod:`importlib`:
- * ``load_module()`` method: use ``exec_module()`` instead.
* :func:`~importlib.util.cache_from_source` *debug_override* parameter is
deprecated: use the *optimization* parameter instead.
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index 3d56ebd75771ee..93da427bfc5abb 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -370,7 +370,7 @@ ABC hierarchy::
:exc:`NotImplementedError`. Functionality provided when
:meth:`exec_module` is available.
- .. deprecated:: 3.4
+ .. deprecated-removed:: 3.4 3.15
The recommended API for loading a module is :meth:`exec_module`
(and :meth:`create_module`). Loaders should implement it instead of
:meth:`load_module`. The import machinery takes care of all the
@@ -474,7 +474,7 @@ ABC hierarchy::
Implementation of :meth:`Loader.load_module`.
- .. deprecated:: 3.4
+ .. deprecated-removed:: 3.4 3.15
use :meth:`exec_module` instead.
@@ -521,7 +521,7 @@ ABC hierarchy::
Calls super's ``load_module()``.
- .. deprecated:: 3.4
+ .. deprecated-removed:: 3.4 3.15
Use :meth:`Loader.exec_module` instead.
.. abstractmethod:: get_filename(fullname)
@@ -610,7 +610,7 @@ ABC hierarchy::
Concrete implementation of :meth:`Loader.load_module`.
- .. deprecated:: 3.4
+ .. deprecated-removed:: 3.4 3.15
Use :meth:`exec_module` instead.
.. method:: get_source(fullname)
@@ -1020,7 +1020,7 @@ find and load modules.
Concrete implementation of :meth:`importlib.abc.Loader.load_module` where
specifying the name of the module to load is optional.
- .. deprecated:: 3.6
+ .. deprecated-removed:: 3.6 3.15
Use :meth:`importlib.abc.Loader.exec_module` instead.
@@ -1063,7 +1063,7 @@ find and load modules.
Concrete implementation of :meth:`importlib.abc.Loader.load_module` where
specifying the name of the module to load is optional.
- .. deprecated:: 3.6
+ .. deprecated-removed:: 3.6 3.15
Use :meth:`importlib.abc.Loader.exec_module` instead.
diff --git a/Lib/importlib/_bootstrap.py b/Lib/importlib/_bootstrap.py
index de5651f0a7fc36..23cad8c5dc1291 100644
--- a/Lib/importlib/_bootstrap.py
+++ b/Lib/importlib/_bootstrap.py
@@ -526,7 +526,7 @@ def _load_module_shim(self, fullname):
"""
msg = ("the load_module() method is deprecated and slated for removal in "
- "Python 3.12; use exec_module() instead")
+ "Python 3.15; use exec_module() instead")
_warnings.warn(msg, DeprecationWarning)
spec = spec_from_loader(fullname, self)
if fullname in sys.modules:
diff --git a/Misc/NEWS.d/next/Library/2025-02-08-15-13-43.gh-issue-97850.jQ0CvW.rst b/Misc/NEWS.d/next/Library/2025-02-08-15-13-43.gh-issue-97850.jQ0CvW.rst
new file mode 100644
index 00000000000000..7b29ffe224cffa
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2025-02-08-15-13-43.gh-issue-97850.jQ0CvW.rst
@@ -0,0 +1,2 @@
+Update the deprecation warning of
+:meth:`importlib.abc.Loader.load_module`.