May 5, 2023 · Sep 15, 2022 · Sep 15, 2022 · Sep 15, 2022 · Sep 15, 2022 · Sep 15, 2022
diff --git a/Include/cpython/frameobject.h b/Include/cpython/frameobject.h

 PyAPI_FUNC(int) PyFrame_FastToLocalsWithError(PyFrameObject *f);
 PyAPI_FUNC(void) PyFrame_FastToLocals(PyFrameObject *);

 /* The following functions are for use by debuggers and other tools
 * implementing custom frame evaluators with PEP 523. */

 /* Returns the code object of the frame.
 * Does not raise an exception. */
 PyAPI_FUNC(PyCodeObject *) _PyInterpreterFrame_GetCode(struct _PyInterpreterFrame *frame);

 /* Returns a byte ofsset into the last executed instruction.
 * Does not raise an exception. */
 PyAPI_FUNC(int) _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);

 /* Returns the currently executing line number, or -1 if there is no line number.
 * Does not raise an exception. */
 PyAPI_FUNC(int) _PyInterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);
diff --git a/Include/internal/pycore_frame.h b/Include/internal/pycore_frame.h
    return new_frame;
 }

 int _PyInterpreterFrame_GetLine(_PyInterpreterFrame *frame);

 static inline
 PyGenObject *_PyFrame_GetGenerator(_PyInterpreterFrame *frame)
 {
diff --git a/Misc/NEWS.d/next/C API/2022-09-15-15-21-34.gh-issue-96803.ynBKIS.rst b/Misc/NEWS.d/next/C API/2022-09-15-15-21-34.gh-issue-96803.ynBKIS.rst
 Expose C-API functions to get the code object, lasti and line number from
 the internal ``_PyInterpreterFrame`` in the limited API. The functions are:

 ``PyCodeObject * _PyInterpreterFrame_GetCode(struct _PyInterpreterFrame
 *frame);``

 ``int _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);``

 ``int _PyInterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);``
diff --git a/Modules/_tracemalloc.c b/Modules/_tracemalloc.c
 #include "pycore_runtime.h"       // _Py_ID()
 #include "pycore_traceback.h"
 #include <pycore_frame.h>
 #include "frameobject.h"          // _PyInterpreterFrame_GetLine

 #include <stdlib.h>               // malloc()

diff --git a/Objects/genobject.c b/Objects/genobject.c
 #include "pycore_pystate.h"       // _PyThreadState_GET()
 #include "structmember.h"         // PyMemberDef
 #include "opcode.h"               // SEND
 #include "frameobject.h"          // _PyInterpreterFrame_GetLine
 #include "pystats.h"

 static PyObject *gen_close(PyGenObject *, PyObject *);
diff --git a/Python/ceval.c b/Python/ceval.c
 #include "pycore_dict.h"
 #include "dictobject.h"
 #include "pycore_frame.h"
 #include "frameobject.h"          // _PyInterpreterFrame_GetLine
 #include "opcode.h"
 #include "pydtrace.h"
 #include "setobject.h"
diff --git a/Python/frame.c b/Python/frame.c
    Py_DECREF(frame->f_code);
 }

 /* Limited API functions */

 PyCodeObject *_PyInterpreterFrame_GetCode(struct _PyInterpreterFrame *frame)
 {
    PyCodeObject *code = frame->f_code;
    Py_INCREF(code);
    return code;
 }

 int _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame)
 {
    return _PyInterpreterFrame_LASTI(frame) * sizeof(_Py_CODEUNIT);
 }

 int
 _PyInterpreterFrame_GetLine(_PyInterpreterFrame *frame)
 {
Original file line number	Diff line number	Diff line change
Expand Up		@@ -27,3 +27,18 @@ PyAPI_FUNC(int) _PyFrame_IsEntryFrame(PyFrameObject *frame);

		PyAPI_FUNC(int) PyFrame_FastToLocalsWithError(PyFrameObject *f);
		PyAPI_FUNC(void) PyFrame_FastToLocals(PyFrameObject *);

		/* The following functions are for use by debuggers and other tools
		* implementing custom frame evaluators with PEP 523. */

		/* Returns the code object of the frame.
markshannon marked this conversation as resolved. Show resolvedHide resolved
		* Does not raise an exception. */
Copy link Member vstinnerSep 15, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Somewhere I saw the expression: "This function cannot fail" but I can no longer find it in the doc.
		PyAPI_FUNC(PyCodeObject ) _PyInterpreterFrame_GetCode(struct _PyInterpreterFrame frame);

		/* Returns a byte ofsset into the last executed instruction.
markshannon marked this conversation as resolved. Show resolvedHide resolved
		* Does not raise an exception. */
		PyAPI_FUNC(int) _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);

		/* Returns the currently executing line number, or -1 if there is no line number.
		* Does not raise an exception. */
		PyAPI_FUNC(int) _PyInterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);
Copy link Member pablogsalSep 15, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Using`struct` here is confusing the Windows compiler Copy link Member vstinnerSep 16, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. You can add`struct _PyInterpreterFrame;` somewhere to declare that "this structure exists" without having to declare the structure members (so it's declared as an opaque structure), to avoid such compiler warning. For example, at the top of this file.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -222,8 +222,6 @@ _PyFrame_PushUnchecked(PyThreadState tstate, PyFunctionObject func)
		return new_frame;
		}

		int _PyInterpreterFrame_GetLine(_PyInterpreterFrame *frame);

		static inline
		PyGenObject _PyFrame_GetGenerator(_PyInterpreterFrame frame)
		{
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,9 @@
		Expose C-API functions to get the code object, lasti and line number from
Copy link Member pablogsalSep 15, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. Not sure if this needs a news entry since the functions are exposed technically on a private header.
		the internal ``_PyInterpreterFrame`` in the limited API. The functions are:
markshannon marked this conversation as resolved. Show resolvedHide resolved

		``PyCodeObject * _PyInterpreterFrame_GetCode(struct _PyInterpreterFrame
		*frame);``

		``int _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame);``

		``int _PyInterpreterFrame_GetLine(struct _PyInterpreterFrame *frame);``
markshannon marked this conversation as resolved. Show resolvedHide resolved
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6,6 +6,7 @@
		#include "pycore_runtime.h" // _Py_ID()
		#include "pycore_traceback.h"
		#include <pycore_frame.h>
		#include "frameobject.h" // _PyInterpreterFrame_GetLine

		#include <stdlib.h> // malloc()

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -13,6 +13,7 @@
		#include "pycore_pystate.h" // _PyThreadState_GET()
		#include "structmember.h" // PyMemberDef
		#include "opcode.h" // SEND
		#include "frameobject.h" // _PyInterpreterFrame_GetLine
		#include "pystats.h"

		static PyObject gen_close(PyGenObject , PyObject *);
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -29,6 +29,7 @@
		#include "pycore_dict.h"
		#include "dictobject.h"
		#include "pycore_frame.h"
		#include "frameobject.h" // _PyInterpreterFrame_GetLine
		#include "opcode.h"
		#include "pydtrace.h"
		#include "setobject.h"
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -118,6 +118,20 @@ _PyFrame_Clear(_PyInterpreterFrame *frame)
		Py_DECREF(frame->f_code);
		}

		/* Limited API functions */
Copy link Member vstinnerSep 15, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. These functions are excluded from the limited API, they are declared in cpython/. Copy link MemberAuthor markshannonSep 15, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. What is the part of the API that isn't portable called? "unlimited", "non-limited"? Copy link Member vstinnerSep 16, 2022 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others.Learn more. The Limited API is supposed to be the most portable. The "not portable" API is called the "Public API". For me, the reference documentation about that is now:https://devguide.python.org/developer-workflow/c-api/index.html#changing-python-s-c-api See also:Include/README.rst.

		PyCodeObject _PyInterpreterFrame_GetCode(struct _PyInterpreterFrame frame)
		{
		PyCodeObject *code = frame->f_code;
		Py_INCREF(code);
		return code;
markshannon marked this conversation as resolved. Show resolvedHide resolved
		}

		int _PyInterpreterFrame_GetLasti(struct _PyInterpreterFrame *frame)
		{
		return _PyInterpreterFrame_LASTI(frame) * sizeof(_Py_CODEUNIT);
		}

		int
		_PyInterpreterFrame_GetLine(_PyInterpreterFrame *frame)
		{
Expand Down