[Python-checkins] cpython: Update the What's New details for importlib based on doc/ABC changes.

[Brett Cannon]

Sorry about accidentally committing another minor cleanup to importlib in
this commit; thought I had already committed it separately.

On Thu, Aug 2, 2012 at 5:50 PM, brett.cannon <python-checkins at python.org>wrote:

> http://hg.python.org/cpython/rev/083534cd7874
> changeset:   78388:083534cd7874
> user:        Brett Cannon <brett at python.org>
> date:        Thu Aug 02 17:50:06 2012 -0400
> summary:
>   Update the What's New details for importlib based on doc/ABC changes.
>
> files:
>   Doc/library/importlib.rst |  10 ++++++----
>   Doc/whatsnew/3.3.rst      |  24 +++++++++++++++++++-----
>   2 files changed, 25 insertions(+), 9 deletions(-)
>
>
> diff --git a/Doc/library/importlib.rst b/Doc/library/importlib.rst
> --- a/Doc/library/importlib.rst
> +++ b/Doc/library/importlib.rst
> @@ -141,9 +141,10 @@
>        longer requires implementation of a ``find_module()`` method.
>
>
> -.. class:: MetaPathFinder(Finder)
> +.. class:: MetaPathFinder
>
> -   An abstract base class representing a :term:`meta path finder`.
> +   An abstract base class representing a :term:`meta path finder` and
> +   inheriting from :class:`Finder`.
>
>     .. versionadded:: 3.3
>
> @@ -156,9 +157,10 @@
>        package. If a loader cannot be found, ``None`` is returned.
>
>
> -.. class:: PathEntryFinder(Finder)
> +.. class:: PathEntryFinder
>
> -   An abstract base class representing a :term:`path entry finder`.
> +   An abstract base class representing a :term:`path entry finder` and
> +   inheriting from :class:`Finder`.
>
>     .. versionadded:: 3.3
>
> diff --git a/Doc/whatsnew/3.3.rst b/Doc/whatsnew/3.3.rst
> --- a/Doc/whatsnew/3.3.rst
> +++ b/Doc/whatsnew/3.3.rst
> @@ -519,7 +519,15 @@
>  making the import statement work. That means the various importers that
> were
>  once implicit are now fully exposed as part of the :mod:`importlib`
> package.
>
> -In terms of finders, * :class:`importlib.machinery.FileFinder` exposes the
> +The abstract base classes defined in :mod:`importlib.abc` have been
> expanded
> +to properly delineate between :term:`meta path finders <meta path finder>`
> +and :term:`path entry finders <path entry finder>` by introducing
> +:class:`importlib.abc.MetaPathFinder` and
> +:class:`importlib.abc.PathEntryFinder`, respectively. The old ABC of
> +:class:`importlib.abc.Finder` is now only provided for
> backwards-compatibility
> +and does not enforce any method requirements.
> +
> +In terms of finders, :class:`importlib.machinery.FileFinder` exposes the
>  mechanism used to search for source and bytecode files of a module.
> Previously
>  this class was an implicit member of :attr:`sys.path_hooks`.
>
> @@ -547,10 +555,10 @@
>
>  Beyond the expanse of what :mod:`importlib` now exposes, there are other
>  visible changes to import. The biggest is that :attr:`sys.meta_path` and
> -:attr:`sys.path_hooks` now store all of the finders used by import
> explicitly.
> -Previously the finders were implicit and hidden within the C code of
> import
> -instead of being directly exposed. This means that one can now easily
> remove or
> -change the order of the various finders to fit one's needs.
> +:attr:`sys.path_hooks` now store all of the meta path finders and path
> entry
> +hooks used by import.  Previously the finders were implicit and hidden
> within
> +the C code of import instead of being directly exposed. This means that
> one can
> +now easily remove or change the order of the various finders to fit one's
> needs.
>
>  Another change is that all modules have a ``__loader__`` attribute,
> storing the
>  loader used to create the module. :pep:`302` has been updated to make this
> @@ -1733,6 +1741,12 @@
>    both the modification time and size of the source file the bytecode
> file was
>    compiled from.
>
> +* :class:`importlib.abc.Finder` no longer specifies a `find_module()`
> abstract
> +  method that must be implemented. If you were relying on subclasses to
> +  implement that method, make sure to check for the method's existence
> first.
> +  You will probably want to check for `find_loader()` first, though, in
> the
> +  case of working with :term:`path entry finders <path entry finder>`.
> +
>  * :mod:`pkgutil` has been converted to use :mod:`importlib` internally.
> This
>    eliminates many edge cases where the old behaviour of the PEP 302 import
>    emulation failed to match the behaviour of the real import system. The
>
> --
> Repository URL: http://hg.python.org/cpython
>
> _______________________________________________
> Python-checkins mailing list
> Python-checkins at python.org
> http://mail.python.org/mailman/listinfo/python-checkins
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-checkins/attachments/20120802/ed7b8f7e/attachment.html>