Importing modules: __main__ vs import as module

by

The __name__ variable always contains the name of the module, except when the file has been loaded into the interpreter as a script instead. Then that variable is set to the string '__main__' instead.

After all, the script is then run as the main file of the whole program, everything else are modules imported directly or indirectly by that main file. By testing the __name__ variable, you can thus detect if a file has been imported as a module, or was run directly.

Internally, modules are given a namespace dictionary, which is stored as part of the metadata for each module, in sys.modules. The main file, the executed script, is stored in that same structure as '__main__'.

But when you import a file as a module, python first looks in sys.modules to see if that module has already been imported before. So, import mod1 means that we first look in sys.modules for the mod1 module. It’ll create a new module structure with a namespace if mod1 isn’t there yet.

So, if you both run mod1.py as the main file, and later import it as a python module, it’ll get two namespace entries in sys.modules. One as '__main__', then later as 'mod1'. These two namespaces are completely separate. Your global var1 is stored in sys.modules['__main__'], but func1B is looking in sys.modules['mod1'] for var1, where it is None.

But when you use python driver.py, driver.py becomes the '__main__' main file of the program, and mod1 will be imported just once into the sys.modules['mod1'] structure. This time round, func1A stores var1 in the sys.modules['mod1'] structure, and that’s what func1B will find.

More Related Contents:

  1. How to properly use relative or absolute imports in Python modules?
  2. How do I import a module given the full path?
  3. How do I unload (reload) a Python module?
  4. How to do relative imports in Python?
  5. How can I import other Python files?
  6. Importing modules from parent folder
  7. `from … import` vs `import .` [duplicate]
  8. Why is Python running my module when I import it, and how do I stop it?
  9. How to import a Python class that is in a directory above?
  10. Callable modules
  11. List all the modules that are part of a python package?
  12. How do I import other Python files?
  13. ModuleNotFoundError: What does it mean __main__ is not a package?
  14. How does python find a module file if the import statement only contains the filename?
  15. Import a python module without running it
  16. How to make global imports from a function?
  17. Python import modules from a higher level package
  18. Prevent Python from caching the imported modules
  19. Python: Why should ‘from import *’ be prohibited?
  20. Import module works in terminal but not in IDLE
  21. How can I import a module dynamically given the full path?
  22. How do I extend a python module? Adding new functionality to the `python-twitter` package
  23. Can you define aliases for imported modules in Python?
  24. ImportError: libSM.so.6: cannot open shared object file: No such file or directory
  25. Importing a library from (or near) a script with the same name raises “AttributeError: module has no attribute” or an ImportError or NameError
  26. How can I do relative imports in Python?
  27. How to reference python package when filename contains a period
  28. How to reload python module imported using `from module import *`
  29. Recursive version of ‘reload’
  30. How does one do the equivalent of “import * from module” with Python’s __import__ function?

Leave a Comment