Addgi_state,cr_state, andag_state attributes to generators, coroutines, and async generators respectively. These attributes return the current state as a string (e.g.,GEN_RUNNING,CORO_SUSPENDED).

Theinspect.getgeneratorstate(),inspect.getcoroutinestate(), andinspect.getasyncgenstate() functions now return these attributes directly.

This is in preparation for makinggi_frame thread-safe, which may involve stop-the-world synchronization. The new state attributes avoid potential performance cliffs ininspect.getgeneratorstate() and similar functions by not requiring frame access.

Issue:SIGSEGV with generators in free-threaded build #120321

📚 Documentation preview 📚:https://cpython-previews--144409.org.readthedocs.build/

pythongh-120321: Add gi_state, cr_state, and ag_state attributes

f3335d3

Add `gi_state`, `cr_state`, and `ag_state` attributes to generators,coroutines, and async generators respectively. These attributes returnthe current state as a string (e.g., `GEN_RUNNING`, `CORO_SUSPENDED`).The `inspect.getgeneratorstate()`, `inspect.getcoroutinestate()`, and`inspect.getasyncgenstate()` functions now return these attributesdirectly.This is in preparation for making `gi_frame` thread-safe, which mayinvolve stop-the-world synchronization. The new state attributes avoidpotential performance cliffs in `inspect.getgeneratorstate()` andsimilar functions by not requiring frame access.