[C API] Move PyFrame_* API to <Python.h>

[vstinner]

Currently, getter functions of a Python frame object (PyFrameObject) are only accessible if the frameobject.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 include frameobject.h. I propose to move these getter functions to Python.h (to pyframe.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

[vstinner]

Done:

• main: commit 27b9894
• 3.11: commit 96254a9

[kumaraditya303]

This is fixed, closing.

[encukou]

I'll reuse this issue to add missing docs.