Commit 07fbd784 authored by Brett Cannon's avatar Brett Cannon

Issue #20488: Update docs to say importlib is *the* implementaiton of

import and not *an* implementation.
parent 5b4fab1a
:mod:`importlib` -- An implementation of :keyword:`import` :mod:`importlib` -- The implementation of :keyword:`import`
========================================================== ===========================================================
.. module:: importlib .. module:: importlib
:synopsis: An implementation of the import machinery. :synopsis: The implementation of the import machinery.
.. moduleauthor:: Brett Cannon <brett@python.org> .. moduleauthor:: Brett Cannon <brett@python.org>
.. sectionauthor:: Brett Cannon <brett@python.org> .. sectionauthor:: Brett Cannon <brett@python.org>
...@@ -13,17 +13,16 @@ ...@@ -13,17 +13,16 @@
Introduction Introduction
------------ ------------
The purpose of the :mod:`importlib` package is two-fold. One is to provide an The purpose of the :mod:`importlib` package is two-fold. One is to provide the
implementation of the :keyword:`import` statement (and thus, by extension, the implementation of the :keyword:`import` statement (and thus, by extension, the
:func:`__import__` function) in Python source code. This provides an :func:`__import__` function) in Python source code. This provides an
implementation of :keyword:`import` which is portable to any Python implementation of :keyword:`import` which is portable to any Python
interpreter. This also provides a reference implementation which is easier to interpreter. This also provides an implementation which is easier to
comprehend than one implemented in a programming language other than Python. comprehend than one implemented in a programming language other than Python.
Two, the components to implement :keyword:`import` are exposed in this Two, the components to implement :keyword:`import` are exposed in this
package, making it easier for users to create their own custom objects (known package, making it easier for users to create their own custom objects (known
generically as an :term:`importer`) to participate in the import process. generically as an :term:`importer`) to participate in the import process.
Details on custom importers can be found in :pep:`302`.
.. seealso:: .. seealso::
...@@ -53,6 +52,9 @@ Details on custom importers can be found in :pep:`302`. ...@@ -53,6 +52,9 @@ Details on custom importers can be found in :pep:`302`.
:pep:`366` :pep:`366`
Main module explicit relative imports Main module explicit relative imports
:pep:`451`
A ModuleSpec Type for the Import System
:pep:`3120` :pep:`3120`
Using UTF-8 as the Default Source Encoding Using UTF-8 as the Default Source Encoding
......
...@@ -379,6 +379,9 @@ Tests ...@@ -379,6 +379,9 @@ Tests
Documentation Documentation
------------- -------------
- Issue #20488: Importlib is no longer *an* implementation of import, it's *the*
implementation.
- Issue #20265: Updated some parts of the Using Windows document. - Issue #20265: Updated some parts of the Using Windows document.
- Issue #20266: Updated some parts of the Windows FAQ. - Issue #20266: Updated some parts of the Windows FAQ.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment