Barry A. Warsaw added the comment:

On May 22, 2016, at 11:30 PM, Martin Panter wrote:

>Here are two examples where publicly-documented module attributes are
>intentionally omitted from __all__:
>
>* Issue 26234: typing.re and typing.io
>* Issue 23439: HTTP status codes like http.client.NOT_FOUND

Wild.

>Despite these, I think @public is a reasonable name. But I may be biased,
>because I personally think everything should be included in
>__all__. Otherwise pydoc does not pick it up.

I think it's pretty reasonable, and pretty well-established despite some
exceptions, that __all__ names a module's public symbols.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue26632>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to