1berry/cpython
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge for issue #20488

Browse Source
This commit is contained in:
Brett Cannon 2014-02-06 09:49:53 -05:00
commit 3303b6abc8
2 changed files with 11 additions and 6 deletions
Show Stats 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

@ -166,6 +166,9 @@ Build
Documentation Documentation
------------- -------------
- Issue #20488: Change wording to say importlib is *the* implementation of
import instead of just *an* implementation.
- Issue #6386: Clarify in the tutorial that specifying a symlink to execute - Issue #6386: Clarify in the tutorial that specifying a symlink to execute
means the directory containing the executed script and not the symlink is means the directory containing the executed script and not the symlink is
added to sys.path. added to sys.path.