New submission from Antti Haapala:

https://docs.python.org/3/tutorial/modules.html#importing-from-a-package

says that 

"The import statement uses the following convention: if a package’s __init__.py 
code defines a list named __all__, it is taken to be the list of module names 
that should be imported when from package import * is encountered."

However, of course this is not true. The behaviour is that `__all__` lists the 
names that are to be imported from the package with from package import *; only 
only those names that raise AttributeError at the time of import would be 
attempted to be imported as submodules.

----------
assignee: docs@python
components: Documentation
messages: 265990
nosy: docs@python, ztane
priority: normal
severity: normal
status: open
title: Confusing text about __all__ in __init__.py in tutorial
type: enhancement

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

Reply via email to