mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-25 12:44:13 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

Doc: Try to enhance wording on circular imports. (GH-24705)

Browse source
This commit is contained in:
Julien Palard 2021-04-13 18:03:22 +02:00 • committed by GitHub
parent eb77133564
commit fd79af7ae2
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

20
Doc/faq/programming.rst
View file

@ -1898,26 +1898,26 @@ How can I have modules that mutually import each other?
Suppose you have the following modules: Suppose you have the following modules:
foo.py:: :file:`foo.py`::
from bar import bar_var from bar import bar_var
foo_var = 1 foo_var = 1
bar.py:: :file:`bar.py`::
from foo import foo_var from foo import foo_var
bar_var = 2 bar_var = 2
The problem is that the interpreter will perform the following steps: The problem is that the interpreter will perform the following steps:
* main imports foo * main imports ``foo``
* Empty globals for foo are created * Empty globals for ``foo`` are created
* foo is compiled and starts executing * ``foo`` is compiled and starts executing
* foo imports bar * ``foo`` imports ``bar``
* Empty globals for bar are created * Empty globals for ``bar`` are created
* bar is compiled and starts executing * ``bar`` is compiled and starts executing
* bar imports foo (which is a no-op since there already is a module named foo) * ``bar`` imports ``foo`` (which is a no-op since there already is a module named ``foo``)
* bar.foo_var = foo.foo_var * The import mechanism tries to read ``foo_var`` from ``foo`` globals, to set ``bar.foo_var = foo.foo_var``
The last step fails, because Python isn't done with interpreting ``foo`` yet and The last step fails, because Python isn't done with interpreting ``foo`` yet and
the global symbol dictionary for ``foo`` is still empty. the global symbol dictionary for ``foo`` is still empty.