add async generators section to asyncio internal docs #135674
+122
−4
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Co-authored-by: Stan Ulbrych <[email protected]>
gvanrossum
reviewed
Jun 22, 2025
| [`asyncio`](https://docs.python.org/3/library/asyncio.html) module. | ||
|
|
||
| # Task management |
There was a problem hiding this comment.
IIUC this section only discusses the C version -- can you call that out somehow? Previously that was implied by the opening sentence above but that has changed now.
There was a problem hiding this comment.
Added a sentence before both section to clarify that.
|
|
||
| The above code will not print "finally executed", because the | ||
| async generator `agen` is not fully iterated over | ||
| and it is not closed manually by awaiting `agen.aclose()`. |
There was a problem hiding this comment.
Is agen.aclose() a shortcut for something? You cannot literally do that ('function' object has no attribute 'aclose'). So what should I wrote to close it manually (if I was so inclined)?
There was a problem hiding this comment.
You can do something like this to close it:
async def main():
g = agen()
async for i in g:
break
await g.aclose()Co-authored-by: Guido van Rossum <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This documents the implementation details of async generators in
asyncio.