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

Ben Finney ben+python at benfinney.id.au
Wed Nov 3 01:47:55 CET 2010


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.

-- 
 \        “Your [government] representative owes you, not his industry |
  `\   only, but his judgment; and he betrays, instead of serving you, |
_o__)        if he sacrifices it to your opinion.” —Edmund Burke, 1774 |
Ben Finney



More information about the Python-Dev mailing list