# This file showcases how imports work with `__all__`.

#

# TL;DR; in `from <module> import *`, if `__all__` is defined in `<module>`, then only

# the names in `__all__` will be imported -- otherwise all names that doesn't begin with

# an underscore will be imported.

#

# If `__all__` is defined, `__all__` must be a sequence for `from <module> import *` to work.

#

# https://docs.python.org/3/reference/simple_stmts.html#the-import-statement

# https://docs.python.org/3/glossary.html#term-sequence

print("import *")

print("---")

from no_all import *

print("no_all.py")

print(" foo={!r}".format(foo))

print(" bar={!r}".format(bar))

print(" baz={!r}".format(baz))

try:

print(" _qux={!r}".format(_qux))

except NameError:

print(" _qux not imported")

del foo, bar, baz

from all_list import *

print("all_list.py")

print(" foo={!r}".format(foo))

print(" bar={!r}".format(bar))

try:

print(" baz={!r}".format(baz))

except NameError:

print(" baz not imported")

del foo, bar

from all_tuple import *

print("all_tuple.py")

print(" foo={!r}".format(foo))

print(" bar={!r}".format(bar))

try:

print(" baz={!r}".format(baz))

except NameError:

print(" baz not imported")

del foo, bar

from all_dynamic import *

print("all_dynamic.py")

print(" foo={!r}".format(foo))

print(" bar={!r}".format(bar))

try:

print(" baz={!r}".format(baz))

except NameError:

print(" baz not imported")

del foo, bar

from all_indirect import *

print("all_indirect.py")

print(" foo={!r}".format(foo))

print(" bar={!r}".format(bar))

try:

print(" baz={!r}".format(baz))

except NameError:

print(" baz not imported")

del foo, bar

# Example of wrong definition of `__all__`, where it is not a sequence.

try:

from all_set import *

except TypeError as e:

assert str(e) == "'set' object does not support indexing"

print("from all_set import * could not be imported:", e)

print("")

print("Direct reference on module")

print("---")

# Direct reference always works, no matter how `__all__` is set.

import no_all

import all_list

import all_tuple

import all_dynamic

import all_indirect

import all_set

for mod in [no_all, all_list, all_tuple, all_dynamic, all_indirect, all_set]:

print("{}.py".format(mod.__name__))

print(" foo={!r}".format(mod.foo))

print(" bar={!r}".format(mod.bar))

print(" baz={!r}".format(mod.baz))

print("\nspecial: no_all._qux={!r}".format(no_all._qux))