bpo-42134: Raise ImportWarning when calling find_module() in the import system (GH-25044)
diff --git a/Doc/reference/import.rst b/Doc/reference/import.rst
index b5ac21d..5d2169b 100644
--- a/Doc/reference/import.rst
+++ b/Doc/reference/import.rst
@@ -329,6 +329,10 @@
import machinery will try it only if the finder does not implement
``find_spec()``.
+.. versionchanged:: 3.10
+ Use of :meth:`~importlib.abc.MetaPathFinder.find_module` by the import system
+ now raises :exc:`ImportWarning`.
+
Loading
=======
@@ -470,6 +474,9 @@
An :exc:`ImportError` is raised when ``exec_module()`` is defined but
``create_module()`` is not.
+.. versionchanged:: 3.10
+ Use of ``load_module()`` will raise :exc:`ImportWarning`.
+
Submodules
----------
@@ -896,6 +903,10 @@
exist on a path entry finder, the import system will always call
``find_loader()`` in preference to ``find_module()``.
+.. versionchanged:: 3.10
+ Calls to :meth:`~importlib.abc.PathEntryFinder.find_module` by the import
+ system will raise :exc:`ImportWarning`.
+
Replacing the standard import system
====================================
diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst
index 3a563c1..e09cfb4 100644
--- a/Doc/whatsnew/3.10.rst
+++ b/Doc/whatsnew/3.10.rst
@@ -1028,6 +1028,15 @@
:meth:`~importlib.abc.Loader.exec_module` is preferred.
(Contributed by Brett Cannon in :issue:`26131`.)
+* The use of :meth:`importlib.abc.MetaPathFinder.find_module` and
+ :meth:`importlib.abc.PathEntryFinder.find_module` by the import system now
+ trigger an :exc:`ImportWarning` as
+ :meth:`importlib.abc.MetaPathFinder.find_spec` and
+ :meth:`importlib.abc.PathEntryFinder.find_spec`
+ are preferred, respectively. You can use
+ :func:`importlib.util.spec_from_loader` to help in porting.
+ (Contributed by Brett Cannon in :issue:`42134`.)
+
* The import system now uses the ``__spec__`` attribute on modules before
falling back on :meth:`~importlib.abc.Loader.module_repr` for a module's
``__repr__()`` method. Removal of the use of ``module_repr()`` is scheduled