]> granicus.if.org Git - python/commit
Implement importlib.abc.SourceLoader and deprecate PyLoader and PyPycLoader.
authorBrett Cannon <bcannon@gmail.com>
Sun, 27 Jun 2010 23:57:46 +0000 (23:57 +0000)
committerBrett Cannon <bcannon@gmail.com>
Sun, 27 Jun 2010 23:57:46 +0000 (23:57 +0000)
commitf23e3744412ac8943bddaace3dc0e85522518319
tree39eff8e07cc68ba5fc7f21cc673cba34ca5742f4
parent22d0830a11c0948ccfd2c42a73d55dd63e35ef72
Implement importlib.abc.SourceLoader and deprecate PyLoader and PyPycLoader.

SourceLoader is a simplification of both PyLoader and PyPycLoader. If one only
wants to use source, then they need to only implement get_data and
get_filename. To also use bytecode -- sourceless loading is not supported --
then two abstract methods -- path_mtime and set_data -- need to be implemented.
Compared to PyLoader and PyPycLoader, there are less abstract methods
introduced and bytecode files become an optimization controlled by the ABC and
hidden from the user (this need came about as PEP 3147 showed that not treating
bytecode as an optimization can cause problems for compatibility).

PyLoader is deprecated in favor of SourceLoader. To be compatible from Python
3.1 onwards, a subclass need only use simple methods for source_path and
is_package. Otherwise conditional subclassing based on whether Python 3.1 or
Python 3.2 is being is the only change. The documentation and docstring for
PyLoader explain what is exactly needed.

PyPycLoader is deprecated also in favor of SourceLoader. Because PEP 3147
shifted bytecode path details so much, there is no foolproof way to provide
backwards-compatibility with SourceLoader. Because of this the class is simply
deprecated and users should move to SourceLoader (and optionally PyLoader for
Python 3.1). This does lead to a loss of support for sourceless loading
unfortunately.

At some point before Python 3.2 is released, SourceLoader will be moved over to
importlib._bootstrap so that the core code of importlib relies on the new code
instead of the old PyPycLoader code. This commit is being done now so that
there is no issue in having the API in Python 3.1a1.
Doc/library/importlib.rst
Lib/importlib/abc.py
Lib/importlib/test/source/test_abc_loader.py
Misc/NEWS