[Python-Dev] On breaking modules into packages Was: [issue10199] Move Demo/turtle under Lib/

exarkun at twistedmatrix.com exarkun at twistedmatrix.com
Wed Nov 3 03:23:47 CET 2010


On 12:47 am, ben+python at benfinney.id.au wrote:
>Antoine Pitrou <solipsis at pitrou.net> writes:
>>I don't agree with this. Until it's documented, it's an implementation
>>detail and should be able to change without notice.
>
>If it's an implementation detail, shouldn't it be named as one (i.e.
>with a leading underscore)?
>>If someone wants to depend on some undocumented detail of the
>>directory layout it's their problem (like people depending on bytecode
>>and other stuff).
>
>I would say that names without a single leading underscore are part of
>the public API, whether documented or not.

And if that isn't the rule, then what the heck is?

Jean-Paul


More information about the Python-Dev mailing list