[Python-Dev] Convention on functions that shadow existing stdlib functions (original) (raw)
Antoine Pitrou solipsis at pitrou.net
Fri Jul 29 17:25:00 CEST 2011
- Previous message: [Python-Dev] Convention on functions that shadow existing stdlib functions
- Next message: [Python-Dev] Convention on functions that shadow existing stdlib functions
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
On Fri, 29 Jul 2011 11🔞37 -0400 Barry Warsaw <barry at python.org> wrote:
I'd much rather solve this problem by adding markup to functions that explicitly disclaim our normal backward compatibility guarantees. Squirreling away documentation for some parts of the stdlib seems similar to security-by-obscurity arguments.
Well, here the whole module should not be called by the user. I'm not sure we want to flag each function individually.
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.
Regards
Antoine.
- Previous message: [Python-Dev] Convention on functions that shadow existing stdlib functions
- Next message: [Python-Dev] Convention on functions that shadow existing stdlib functions
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]