bpo-45619: documentation of execution model: clarify and update binding summary (#29232)

This does two changes that are quite related.

0. it add that variable binding can occur in pattern matching, an update of 3.10
which seems to have been omitted from the list of bindings
1. Given how long the sentence already was, with even subcases in the middle of
the sentence, the commit breaks the sentence into an actual list.
This commit is contained in:
Arthur Milchior 2021-11-26 06:19:06 +01:00 committed by GitHub
parent 93c65df83c
commit cd876c8493
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -56,15 +56,25 @@ Binding of names
.. index:: single: from; import statement .. index:: single: from; import statement
The following constructs bind names: formal parameters to functions, The following constructs bind names:
:keyword:`import` statements, class and function definitions (these bind the
class or function name in the defining block), and targets that are identifiers * formal parameters to functions,
if occurring in an assignment, :keyword:`for` loop header, or after * class definitions,
:keyword:`!as` in a :keyword:`with` statement or :keyword:`except` clause. * function definitions,
The :keyword:`!import` statement * assignment expressions,
of the form ``from ... import *`` binds all names defined in the imported * :ref:`targets <assignment>` that are identifiers if occurring in
module, except those beginning with an underscore. This form may only be used an assignment:
at the module level.
+ :keyword:`for` loop header,
+ after :keyword:`!as` in a :keyword:`with` statement, :keyword:`except`
clause or in the as-pattern in structural pattern matching,
+ in a capture pattern in structural pattern matching
* :keyword:`import` statements.
The :keyword:`!import` statement of the form ``from ... import *`` binds all
names defined in the imported module, except those beginning with an underscore.
This form may only be used at the module level.
A target occurring in a :keyword:`del` statement is also considered bound for A target occurring in a :keyword:`del` statement is also considered bound for
this purpose (though the actual semantics are to unbind the name). this purpose (though the actual semantics are to unbind the name).