Currently, getter functions of a Python frame object (PyFrameObject) are only accessible if theframeobject.h header is included explicitly. It's not documented in the frame doc:https://docs.python.org/dev/c-api/frame.html

In Python 3.11, the PyFrameObject structure was moved to the internal C API. Third party C extensions now must only use getter functions, as explained in What's New in Python 3.11:https://docs.python.org/dev/whatsnew/3.11.html#id6

Problem: functions like PyFrame_GetBack() requires to includeframeobject.h. I propose to move these getter functions toPython.h (topyframe.h in practice) to make these functions less special.

Linked PRs

• gh-93937: Document PyFrame_Check and PyFrame_Type #99695
• [3.11] gh-93937: Document PyFrame_Check and PyFrame_Type (GH-99695) #99697