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

bpo-13814: Explain why generators are not context managers (GH-26835)

Browse source 
Put entry in Design FAQ after a question about a context manager for assignment.
Original patch by Aidan Lowe.
(cherry picked from commit 51f45d085d)

Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu>
This commit is contained in:
Miss Islington (bot) 2021-06-21 15:03:06 -07:00 • committed by GitHub
parent 67b3a99953
commit d881002fbd
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 10 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

9
Doc/faq/design.rst
View file

@ -709,6 +709,15 @@ bindings are resolved at run-time in Python, and the second version only needs
to perform the resolution once. to perform the resolution once.
Why don't generators support the with statement?
------------------------------------------------
For technical reasons, a generator used directly as a context manager
would not work correctly. When, as is most common, a generator is used as
an iterator run to completion, no closing is needed. When it is, wrap
it as "contextlib.closing(generator)" in the 'with' statment.
Why are colons required for the if/while/def/class statements? Why are colons required for the if/while/def/class statements?
-------------------------------------------------------------- --------------------------------------------------------------

1
Misc/NEWS.d/next/Documentation/2021-06-21-15-46-32.bpo-13814.LDcslu.rst Normal file
View file

@ -0,0 +1 @@
In the Design FAQ, answer "Why don't generators support the with statement?"