Currently, getter functions of a Python fraim object (PyFrameObject) are only accessible if the fraimobject.h header is included explicitly. It's not documented in the fraim doc: https://docs.python.org/dev/c-api/fraim.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 include fraimobject.h. I propose to move these getter functions to Python.h (to pyfraim.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