On 3/3/21 2:17 PM, Brendan Barnwell wrote:

[...] usually you want to define [__all__] at the beginning as a sort of 
documentation
aid ("this is the public API").

That is its purpose. :-)

I do think something like __exclude_all__ would be handy.  It can be annoying 
to have
to define __all__ just to exclude a few things.

Exclude a few things from what?  *-imports?  If you're using *-imports that 
often you are already courting confusion (where did that name come from?  why 
is this name not that function?).

I maintain a handful of libraries, all with `__all__`, and only one them is 
designed to be used with `from ... import *`.

The presence or absence of `__all__` has no bearing on named imports.  `from 
blahblah import _xyz` will work in either case.

--
~Ethan~
_______________________________________________
Python-ideas mailing list -- python-ideas@python.org
To unsubscribe send an email to python-ideas-le...@python.org
https://mail.python.org/mailman3/lists/python-ideas.python.org/
Message archived at 
https://mail.python.org/archives/list/python-ideas@python.org/message/4LLOJWIAMUGYPOTA6GPQ3SLRT7HOSSHV/
Code of Conduct: http://python.org/psf/codeofconduct/

Reply via email to