cpython/Lib/importlib/NOTES

to do
/////

* Fill in docstrings for ABCs.

* Implement InspectLoader for BuiltinImporter and FrozenImporter.

    + Expose function to see if a frozen module is a package.

* Make sure that there is documentation *somewhere* fully explaining the
semantics of import that can be referenced from the package's documentation
(even if it is in the package documentation itself, although it might be best
in the language specification).
Add initial implementation of importlib. See the NOTES files for what is planned for the package. There are no docs yet, but they are coming once the API for the first new function, importlib.import_module() is finalized. 2009-01-18 00:24:28 +00:00			`to do`
			`/////`

Add a NOTE for importlib to fill in the docstrings for the ABCs. 2009-03-11 05:14:27 +00:00			`* Fill in docstrings for ABCs.`

Introduce importlib.abc. The module contains various ABCs related to imports (mostly stuff specified by PEP 302). There are two ABCs, PyLoader and PyPycLoader, which help with implementing source and source/bytecode loaders by implementing load_module in terms of other methods. This removes a lot of gritty details loaders typically have to worry about. 2009-03-09 03:35:50 +00:00			`* Implement InspectLoader for BuiltinImporter and FrozenImporter.`
Add importlib.machinery with its first tenants, BuitinImporter and FrozenImporter. Docs forthcoming. I plan on all finders and loaders (and most likely hooks) to live in imoprtlib.machinery. Utility stuff will end up in importlib.util. Higher-level API stuff will stay on imoprtlib directly (e.g. import_module). 2009-01-22 22:43:07 +00:00
Introduce importlib.abc. The module contains various ABCs related to imports (mostly stuff specified by PEP 302). There are two ABCs, PyLoader and PyPycLoader, which help with implementing source and source/bytecode loaders by implementing load_module in terms of other methods. This removes a lot of gritty details loaders typically have to worry about. 2009-03-09 03:35:50 +00:00			`+ Expose function to see if a frozen module is a package.`
Rewrite the code implementing __import__ for importlib. Now it is much simpler and relies much more on meta path finders to abstract out various parts of import. As part of this the semantics for import_module tightened up and now follow __import__ much more closely (biggest thing is that the 'package' argument must now already be imported, else a SystemError is raised). 2009-02-07 01:15:27 +00:00
Document importlib.machinery.PathFinder. 2009-02-16 04:18:01 +00:00			`* Make sure that there is documentation somewhere fully explaining the`
			`semantics of import that can be referenced from the package's documentation`
			`(even if it is in the package documentation itself, although it might be best`
			`in the language specification).`