Why might Python’s `from` form of an import statement bind a module name?

by

From the import system documentation:

When a submodule is loaded using any mechanism (e.g. importlib APIs,
the import or import-from statements, or built-in __import__())
a binding is placed in the parent module’s namespace to the submodule
object. For example, if package spam has a submodule foo, after
importing spam.foo, spam will have an attribute foo which is
bound to the submodule. Let’s say you have the following directory
structure:

spam/
    __init__.py
    foo.py
    bar.py

and spam/__init__.py has the following lines in it:

from .foo import Foo
from .bar import Bar

then executing the following puts a name binding to foo and bar in
the spam module:

>>> import spam
>>> spam.foo
<module 'spam.foo' from '/tmp/imports/spam/foo.py'>
>>> spam.bar
<module 'spam.bar' from '/tmp/imports/spam/bar.py'>

Given Python’s familiar name binding rules this might seem surprising,
but it’s actually a fundamental feature of the import system. The
invariant holding is that if you have sys.modules['spam'] and
sys.modules['spam.foo'] (as you would after the above import), the
latter must appear as the foo attribute of the former.

If you do from testapp.api.utils import x, the import statement will not load utils into the local namespace. However, the import machinery will load utils into the testapp.api namespace, to make further imports work right. It just happens that in your case, testapp.api is also the local namespace, so you’re getting a surprise.

More Related Contents:

  1. Defined variable is not defined
  2. open .txt file and place every word within a dictionary [closed]
  3. ImportError: No module named ‘pygame’
  4. beyond top level package error in relative import
  5. What is the purpose of a backslash at the end of a line?
  6. Importing from builtin library when module with same name exists
  7. Import module from subfolder
  8. Can’t import my own modules in Python
  9. Can’t import my own modules in Python
  10. How do you import a file in python with spaces in the name?
  11. How to import module when module name has a ‘-‘ dash or hyphen in it?
  12. Python module with a dash, or hyphen (-) in its name
  13. Use a library locally instead of installing it
  14. Import Script from a Parent Directory
  15. What could cause a python module to be imported twice?
  16. Namespaces with Module Imports
  17. Difference between “import X” and “from X import *”? [duplicate]
  18. Python basemap module impossible to import
  19. Importing classes from different files in a subdirectory
  20. Relative imports in python 2.5
  21. Prevent Python from caching the imported modules
  22. from … import OR import … as for modules
  23. How can I import from the standard library, when my project has a module with the same name? (How can I control where Python looks for modules?)
  24. Python, doing conditional imports the right way
  25. Dynamically import a method in a file, from a string
  26. Why doesn’t an import in an exec in a function work?
  27. import a function from another .ipynb file
  28. using variable in import command
  29. python import module from parent package
  30. How do I import a Python script from a sibling directory?

Leave a Comment