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

Antoine Pitrou solipsis at pitrou.net
Fri Jul 29 23:32:57 CEST 2011

On Fri, 29 Jul 2011 11:51:18 -0400 Barry Warsaw <barry at python.org> wrote:

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.

Ideally so. Practically, it's a lot of churn and additional pain merging 3.2 bugfixes into default. The lack of an underscore doesn't always mean the API is public, because it hasn't always worked like this (we have many private APIs without an underscore).

Regards

Antoine.

More information about the Python-Dev mailing list