[Python-Dev] Convention on functions that shadow existing stdlib functions
Barry Warsaw
barry at python.org
Fri Jul 29 17:51:18 CEST 2011
On Jul 29, 2011, at 05:25 PM, Antoine Pitrou wrote:
>> test.support *is* part of the stdlib.
>
>We have lots of internal APIs which are not documented, though.
>And test.support *is* for internal use.
The solution then is to rename test.support to test._support to make it clear
it's an internal implementation detail. Then you can remove the entire
section from the stdlib docs and just document it in the code.
-Barry
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/python-dev/attachments/20110729/51bf2031/attachment.pgp>
More information about the Python-Dev
mailing list