Add PyFrame_GetLasti() function

Author: vstinner

docs/api.rst

@@ -39,6 +39,12 @@ Python 3.11
 
    Not available on PyPy.
 
+.. c:function:: int PyFrame_GetLasti(PyFrameObject *frame)
+
+   See `PyFrame_GetLasti() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetLasti>`__.
+
+   Not available on PyPy.
+
 .. c:function:: PyObject* PyFrame_GetLocals(PyFrameObject *frame)
 
    See `PyFrame_GetLocals() documentation <https://docs.python.org/dev/c-api/frame.html#c.PyFrame_GetLocals>`__.

docs/changelog.rst

@@ -1,8 +1,8 @@
 Changelog
 =========
 
-* 2022-04-07: Add functions ``PyFrame_GetLocals()``, ``PyFrame_GetGlobals()``
-  and ``PyFrame_GetBuiltins()``.
+* 2022-04-08: Add functions ``PyFrame_GetLocals()``, ``PyFrame_GetGlobals()``
+  ``PyFrame_GetBuiltins()``, and ``PyFrame_GetLasti()``.
 * 2022-03-12: Add functions ``PyFloat_Pack2()``, ``PyFloat_Pack4()``,
   ``PyFloat_Pack8()``, ``PyFloat_Unpack2()``, ``PyFloat_Unpack4()`` and
   ``PyFloat_Unpack8()``.

pythoncapi_compat.h

@@ -207,7 +207,7 @@ _PyFrame_GetBackBorrow(PyFrameObject *frame)
 
 // bpo-40421 added PyFrame_GetLocals() to Python 3.11.0a7
 #if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
-PyObject*
+PYCAPI_COMPAT_STATIC_INLINE(PyObject*)
 PyFrame_GetLocals(PyFrameObject *frame)
 {
 #if PY_VERSION_HEX >= 0x030400B1
@@ -224,7 +224,7 @@ PyFrame_GetLocals(PyFrameObject *frame)
 
 // bpo-40421 added PyFrame_GetGlobals() to Python 3.11.0a7
 #if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
-PyObject*
+PYCAPI_COMPAT_STATIC_INLINE(PyObject*)
 PyFrame_GetGlobals(PyFrameObject *frame)
 {
     return Py_NewRef(frame->f_globals);
@@ -234,14 +234,24 @@ PyFrame_GetGlobals(PyFrameObject *frame)
 
 // bpo-40421 added PyFrame_GetBuiltins() to Python 3.11.0a7
 #if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
-PyObject*
+PYCAPI_COMPAT_STATIC_INLINE(PyObject*)
 PyFrame_GetBuiltins(PyFrameObject *frame)
 {
     return Py_NewRef(frame->f_builtins);
 }
 #endif
 
 
+// bpo-40421 added PyFrame_GetLasti() to Python 3.11.0b1
+#if PY_VERSION_HEX < 0x030B00A7 && !defined(PYPY_VERSION)
+PYCAPI_COMPAT_STATIC_INLINE(int)
+PyFrame_GetLasti(PyFrameObject *frame)
+{
+    return frame->f_lasti;
+}
+#endif
+
+
 // bpo-39947 added PyThreadState_GetInterpreter() to Python 3.9.0a5
 #if PY_VERSION_HEX < 0x030900A5
 PYCAPI_COMPAT_STATIC_INLINE(PyInterpreterState *)

tests/test_pythoncapi_compat_cext.c

@@ -232,6 +232,10 @@ test_frame(PyObject *Py_UNUSED(module), PyObject* Py_UNUSED(ignored))
     Py_DECREF(globals);
     Py_DECREF(builtins);
 
+    // test PyFrame_GetLasti()
+    int lasti = PyFrame_GetLasti(frame);
+    assert(lasti >= 0);
+
     Py_DECREF(frame);
     Py_RETURN_NONE;
 }