[Python-Dev] Breaking undocumented API

Georg Brandl g.brandl at gmx.net
Wed Nov 17 22:22:50 CET 2010


Am 17.11.2010 22:16, schrieb Éric Araujo:
>> Excluding a builtin name from __all__ sounds like a perfectly sensible
>> idea, so even if it wasn't deliberate, I'd say it qualifies as
>> fortuitous :)
> 
> But then, a tool that looks into __all__ to find for example what
> objects to document will miss open.  I’d put open in __all__.

So it comes down again to what we'd like __all__ to mean foremost:
public API, or just a list for "import *"?

Georg



More information about the Python-Dev mailing list