Skip to content

GH-100108: Add async generators best practices section #141885

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kumaraditya303 merged 14 commits into from
Mar 21, 2026
Merged

GH-100108: Add async generators best practices section #141885

Changes from 1 commit
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
8fb10ee
Add async generators best practices section
sergey-miryanov Nov 23, 2025
ae50f3f
Update Doc/library/asyncio-dev.rst
sergey-miryanov Nov 24, 2025
99f148c
Fix spacing between sections
sergey-miryanov Nov 24, 2025
11242b4
Apply suggestions from code review
sergey-miryanov Nov 26, 2025
3556aef
Fix copy-paste typo
sergey-miryanov Nov 26, 2025
a70038a
Update section about iterating agen after running event loop
sergey-miryanov Nov 26, 2025
d0e1b58
Merge branch 'main' into 100108-async-gen-docs
sergey-miryanov Feb 20, 2026
5256508
Address reviews
sergey-miryanov Feb 20, 2026
97ccca0
Add example for broken finalizers
sergey-miryanov Feb 25, 2026
6ebf294
Fix
sergey-miryanov Feb 25, 2026
100d9ac
Fix anext
sergey-miryanov Feb 25, 2026
d910ee7
Add example
sergey-miryanov Feb 26, 2026
b5c3ddc
Fix wording
sergey-miryanov Mar 21, 2026
c1daefb
Merge branch 'main' into 100108-async-gen-docs
kumaraditya303 Mar 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Fix
  • Loading branch information
@sergey-miryanov
sergey-miryanov committed Feb 25, 2026
commit 6ebf2945c7357ea504fcca2417bcb9c9c6d69e73
2 changes: 1 addition & 1 deletion Doc/library/asyncio-dev.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -377,8 +377,8 @@
Avoid iterating and closing the same generator concurrently
-----------------------------------------------------------

Async generators may to be reentered while another

Check warning on line 380 in Doc/library/asyncio-dev.rst

View workflow job for this annotation

GitHub Actions / Docs / Docs 

py:meth reference target not found: agen.anext [ref.meth]
:meth:`~agen.anext`/:meth:`~agen.athrow`/:meth:`~agen.aclose` call is in
:meth:`~agen.anext` / :meth:`~agen.athrow` / :meth:`~agen.aclose` call is in
progress. This may lead to an inconsistent state of the async generator
and can cause errors.

Expand Down
Loading