[Distutils] distlib.mount API design (was: wheels on sys.path clarification (reboot))

[Vinay Sajip]

Paul Moore <p.f.moore <at> gmail.com> writes:

> I *would* like to see the various technical issues and implications in
> the API documentation, though. The implications and limitations, and
> in particular the manual cache management requirements, need to be
> made explicit.

I've updated the documentation, see

http://distlib.readthedocs.org/en/latest/reference.html

The docs on distlib.util.get_cache_base have the info on the cache and
cleanup thereof, including handling of no-home-directory, security
implications, open files in Windows etc.

I've also updated the distlib.resources.Cache documentation to link to
get_cache_base.

I've added is_mountable and is_compatible methods to Wheel, and added/
updated the docs for them and the mount() method accordingly, and
referenced get_cache_base as the place where extensions are extracted to.

More detailed suggestions for improvements are welcome.

Regards,

Vinay Sajip