RetroSearch Browse

Fri Jul 29 23:32:57 CEST 2011 · https://mail.python.org/pipermail/python-dev/2011-July/112662.html

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.

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://mail.python.org/pipermail/python-dev/2011-July/112662.html below:

[Python-Dev] Convention on functions that shadow existing stdlib functions