summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorNikita Sobolev <mail@sobolevn.me>2022-10-07 00:57:10 (GMT)
committerGitHub <noreply@github.com>2022-10-07 00:57:10 (GMT)
commit27025e158c70331d0a8fb42fe234a2a6770850d1 (patch)
tree7a65a7e92f1db72ce3d942f32af13dfe40ed2462 /Doc
parent4875433682ffec2694647ac43f1b21f5ad73fd25 (diff)
downloadcpython-27025e158c70331d0a8fb42fe234a2a6770850d1.zip
cpython-27025e158c70331d0a8fb42fe234a2a6770850d1.tar.gz
cpython-27025e158c70331d0a8fb42fe234a2a6770850d1.tar.bz2
gh-97850: Remove deprecated functions from `importlib.utils` (#97898)
* gh-97850: Remove deprecated functions from `importlib.utils` * Rebase and remove `set_package` from diff
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/importlib.rst54
1 files changed, 1 insertions, 53 deletions
diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
index a7c067c..3fc1531 100644
--- a/Doc/library/importlib.rst
+++ b/Doc/library/importlib.rst
@@ -443,7 +443,7 @@ ABC hierarchy::
from the import. If the loader inserted a module and the load fails, it
must be removed by the loader from :data:`sys.modules`; modules already
in :data:`sys.modules` before the loader began execution should be left
- alone (see :func:`importlib.util.module_for_loader`).
+ alone.
The loader should set several attributes on the module
(note that some of these attributes can change when a module is
@@ -1326,58 +1326,6 @@ an :term:`importer`.
.. versionadded:: 3.5
-.. decorator:: module_for_loader
-
- A :term:`decorator` for :meth:`importlib.abc.Loader.load_module`
- to handle selecting the proper
- module object to load with. The decorated method is expected to have a call
- signature taking two positional arguments
- (e.g. ``load_module(self, module)``) for which the second argument
- will be the module **object** to be used by the loader.
- Note that the decorator will not work on static methods because of the
- assumption of two arguments.
-
- The decorated method will take in the **name** of the module to be loaded
- as expected for a :term:`loader`. If the module is not found in
- :data:`sys.modules` then a new one is constructed. Regardless of where the
- module came from, :attr:`__loader__` set to **self** and :attr:`__package__`
- is set based on what :meth:`importlib.abc.InspectLoader.is_package` returns
- (if available). These attributes are set unconditionally to support
- reloading.
-
- If an exception is raised by the decorated method and a module was added to
- :data:`sys.modules`, then the module will be removed to prevent a partially
- initialized module from being in left in :data:`sys.modules`. If the module
- was already in :data:`sys.modules` then it is left alone.
-
- .. versionchanged:: 3.3
- :attr:`__loader__` and :attr:`__package__` are automatically set
- (when possible).
-
- .. versionchanged:: 3.4
- Set :attr:`__name__`, :attr:`__loader__` :attr:`__package__`
- unconditionally to support reloading.
-
- .. deprecated:: 3.4
- The import machinery now directly performs all the functionality
- provided by this function.
-
-.. decorator:: set_loader
-
- A :term:`decorator` for :meth:`importlib.abc.Loader.load_module`
- to set the :attr:`__loader__`
- attribute on the returned module. If the attribute is already set the
- decorator does nothing. It is assumed that the first positional argument to
- the wrapped method (i.e. ``self``) is what :attr:`__loader__` should be set
- to.
-
- .. versionchanged:: 3.4
- Set ``__loader__`` if set to ``None``, as if the attribute does not
- exist.
-
- .. deprecated:: 3.4
- The import machinery takes care of this automatically.
-
.. function:: spec_from_loader(name, loader, *, origin=None, is_package=None)
A factory function for creating a :class:`~importlib.machinery.ModuleSpec`