https://github.com/python/cpython/commit/b8ebd078f90007d48fcab85effadb33769cd080c
commit: b8ebd078f90007d48fcab85effadb33769cd080c
branch: main
author: Kit Dallege <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2026-05-04T17:45:00+03:00
summary:
gh-137337: Clarify import statement namespace binding (GH-144607)
It is not always in the local namespace.
files:
M Doc/reference/simple_stmts.rst
diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst
index 648e3a9bf54060..f8e54aa0a108c8 100644
--- a/Doc/reference/simple_stmts.rst
+++ b/Doc/reference/simple_stmts.rst
@@ -761,8 +761,9 @@ The basic import statement (no :keyword:`from` clause) is
executed in two
steps:
#. find a module, loading and initializing it if necessary
-#. define a name or names in the local namespace for the scope where
- the :keyword:`import` statement occurs.
+#. define a name or names in the current namespace for the scope where
+ the :keyword:`import` statement occurs, just as an assignment statement
+ would (including :keyword:`global` and :keyword:`nonlocal` semantics).
When the statement contains multiple clauses (separated by
commas) the two steps are carried out separately for each clause, just
@@ -807,7 +808,7 @@ The :keyword:`from` form uses a slightly more complex
process:
#. if not, attempt to import a submodule with that name and then
check the imported module again for that attribute
#. if the attribute is not found, :exc:`ImportError` is raised.
- #. otherwise, a reference to that value is stored in the local namespace,
+ #. otherwise, a reference to that value is stored in the current namespace,
using the name in the :keyword:`!as` clause if it is present,
otherwise using the attribute name
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
