On May 25, 2012, at 10:31 AM, Brett Cannon wrote:

>Is documentation coming in a separate commit?

Yes.  I've been reworking the import machinery documentation; it's a
work-in-progress on the pep-420 feature clone ('importdocs' branch).  I made
some good progress and then got side-tracked, but I'm planning on getting back
to it soon.

OK, great! Something to keep in the back of your head, Barry, is the naming of importlib.find_loader(). Since its return value is not the same as what the PEP introduces it might stand for a name change (it's new in Python 3.3 so it can be whatever makes sense).
">

(original) (raw)



On Fri, May 25, 2012 at 10:41 AM, Barry Warsaw <barry@python.org> wrote:

On May 25, 2012, at 10:31 AM, Brett Cannon wrote:

>Is documentation coming in a separate commit?

Yes. I've been reworking the import machinery documentation; it's a
work-in-progress on the pep-420 feature clone ('importdocs' branch). I made
some good progress and then got side-tracked, but I'm planning on getting back
to it soon.

OK, great! Something to keep in the back of your head, Barry, is the naming of importlib.find\_loader(). Since its return value is not the same as what the PEP introduces it might stand for a name change (it's new in Python 3.3 so it can be whatever makes sense).

Also just noticed that there is no update to importlib.abc.Finder for find\_loader(), which I assume is because of the hasattr() check in PathFinder. That's fine, but it would be good to update the docs for ABC so people know that is an optional interface they can implement.