[Python-Dev] Convention on functions that shadow existing stdlib functions (original) (raw)

Antoine Pitrou solipsis at pitrou.net
Wed Jul 27 22:34:46 CEST 2011

On Wed, 27 Jul 2011 10:27:16 -0700 Brett Cannon <brett at python.org> wrote:

> > Perhaps what we could do is move the documentation for test.support to > the devguide, and then vet the test suite so that unlink and friends > are always called as 'support.unlink', etc. >

I like this solution since this issue of documenting test.support keeps coming up. Otherwise we can not document test.support, but then we need to do a pass through the module to make sure that the docstrings are properly updated and we start deprecating some of the stuff in there that is just pure cruft.

We don't need to deprecate that cruft, we can just remove it (and all uses of it, of course).

Regards

Antoine.

More information about the Python-Dev mailing list