From: wangxiaolei <fatelei@gmail.com>
Date: Sun, 28 Dec 2025 18:03:30 +0000 (+0800)
Subject: gh-142994, gh-142996: document missing async generator and coroutine field entries... 
X-Git-Tag: v3.15.0a5~11^2~183
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0efbad60e13cbc8b27a5ca3a5d9afcdcc957b19e;p=thirdparty%2FPython%2Fcpython.git

gh-142994, gh-142996: document missing async generator and coroutine field entries in `inspect` (#142997)
---

diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index e5abd68f03b9..9e53dd70ab56 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -273,6 +273,9 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 +-----------------+-------------------+---------------------------+
 |                 | ag_running        | is the generator running? |
 +-----------------+-------------------+---------------------------+
+|                 | ag_suspended      | is the generator          |
+|                 |                   | suspended?                |
++-----------------+-------------------+---------------------------+
 |                 | ag_code           | code                      |
 +-----------------+-------------------+---------------------------+
 | coroutine       | __name__          | name                      |
@@ -286,6 +289,9 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 +-----------------+-------------------+---------------------------+
 |                 | cr_running        | is the coroutine running? |
 +-----------------+-------------------+---------------------------+
+|                 | cr_suspended      | is the coroutine          |
+|                 |                   | suspended?                |
++-----------------+-------------------+---------------------------+
 |                 | cr_code           | code                      |
 +-----------------+-------------------+---------------------------+
 |                 | cr_origin         | where coroutine was       |
@@ -319,6 +325,18 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 
    Add ``__builtins__`` attribute to functions.
 
+.. versionchanged:: 3.11
+
+   Add ``gi_suspended`` attribute to generators.
+
+.. versionchanged:: 3.11
+
+   Add ``cr_suspended`` attribute to coroutines.
+
+.. versionchanged:: 3.12
+
+   Add ``ag_suspended`` attribute to async generators.
+
 .. versionchanged:: 3.14
 
    Add ``f_generator`` attribute to frames.