mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-13 23:46:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

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

Browse source 
import and not *an* implementation.
This commit is contained in:
Brett Cannon 2014-02-06 09:46:08 -05:00
parent 5b4fab1ad7
commit 07fbd78473
2 changed files with 11 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/library/importlib.rst
View file

@ -1,8 +1,8 @@
: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 @@
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`.
: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

3
Misc/NEWS
View file

@ -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.