[Python-checkins] r50818 - peps/trunk/pep-0356.txt

[Nick Coghlan]

georg.brandl wrote:
> Author: georg.brandl
> Date: Tue Jul 25 12:20:43 2006
> New Revision: 50818
> 
> Modified:
>    peps/trunk/pep-0356.txt
> Log:
> Add item: docs of pkgutil changes.

I'm not sure about the intent of this one. What did you feel needs documenting?

Many of the changes to pkgutil were a matter of consolidating two different 
PEP 302 compliant emulations of the standard import machinery (one in runpy, 
one in test_import) into a single copy.

Leaving this part undocumented makes sense to me, as it is really only 
intended for standard library internal use - we don't currently want to 
promise that pkgutil will continue to export pkgutil.getloader() after the 
real imp.getloader() is implemented.

runpy.run_module definitely has some corner cases where it can't set certain 
special variables correctly (e.g. it doesn't know how to set __file__ 
correctly when running a module from a zip file), but the runpy.run_module 
docs state explicitly that __file__ may sometimes be set to None instead of 
the proper string value.

The issues with relative imports are a fair bit more esoteric, which is why I 
relegated them to a section in PEP 338 for the time being.

For the pydoc changes, I thought those were simply a matter of making pydoc 
work as advertised for modules in more locations - the public interface didn't 
actually change, did it? (PJE is no doubt in a better position to comment on 
that one)

Cheers,
Nick.

-- 
Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia
---------------------------------------------------------------
             http://www.boredomandlaziness.org