From 131621948740861a6f4f08a00670da1f67a49f81 Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Sun, 9 Nov 2025 11:32:32 -0500 Subject: [PATCH 1/3] Document PyExceptionInstance* APIs --- Doc/c-api/exceptions.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index c58aa659e1b1b4..0b85fe03312ec2 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -788,6 +788,17 @@ Exception Classes Exception Objects ================= +.. c:function:: int PyExceptionInstance_Check(PyObject *op) + + Return true if *op* is an instance of :class:`BaseException`, false + otherwise. This function always succeeds. + + +.. c:macro:: PyExceptionInstance_Class(op) + + Equivalent to :c:expr:`Py_TYPE(op)`. + + .. c:function:: PyObject* PyException_GetTraceback(PyObject *ex) Return the traceback associated with the exception as a new reference, as From f3211fff94ab9bfd4c344ec90bf4c133c740c179 Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Sun, 9 Nov 2025 11:41:30 -0500 Subject: [PATCH 2/3] Don't use :c:expr: --- Doc/c-api/exceptions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index 0b85fe03312ec2..9981d08d273e35 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -796,7 +796,7 @@ Exception Objects .. c:macro:: PyExceptionInstance_Class(op) - Equivalent to :c:expr:`Py_TYPE(op)`. + Equivalent to ``Py_TYPE(op)``. .. c:function:: PyObject* PyException_GetTraceback(PyObject *ex) From 9aadd5720929da2700f92b284761bff873100398 Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Sun, 9 Nov 2025 12:03:17 -0500 Subject: [PATCH 3/3] Update Doc/c-api/exceptions.rst Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com> --- Doc/c-api/exceptions.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index 9981d08d273e35..5241533e11281f 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -796,7 +796,7 @@ Exception Objects .. c:macro:: PyExceptionInstance_Class(op) - Equivalent to ``Py_TYPE(op)``. + Equivalent to :c:func:`Py_TYPE(op) `. .. c:function:: PyObject* PyException_GetTraceback(PyObject *ex)