homepage

The function _PyErr_GetTopmostException() is not exported and is useful to get access to exceptions info from a PyThreadState.

The function was added by:
commit ae3087c6382011c47db82fea4d05f8bbf514265d
Author: Mark Shannon <mark@hotpy.org>
Date: Sun Oct 22 22:41:51 2017 +0100
 Move exc state to generator. Fixes bpo-25612 (#1773)
 
 Move exception state information from frame objects to coroutine (generator/thread) object where it belongs.
Python 3.9 is now built with -fvisibility=hidden, bpo-11410:
commit 0b60f64e4343913b4931dc27379d9808e5b78fe1
Author: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Tue Oct 15 08:26:12 2019 +0100
 bpo-11410: Standardize and use symbol visibility attributes across POSIX and Windows. (GH-16347)
It means that functions which are not explicitly exported are no longer exported.
So yeah, _PyErr_GetTopmostException() symbol is not properly exported.
But the function remains private. IMHO if someone wants to add a *public* function, it should return a *strong* reference to the 3 variables (exc type, exc value, exc tb).
See also bpo-39947: "[C API] Make the PyThreadState structure opaque (move it to the internal C API)". I added multiple public getters for PyThreadState structure in Python 3.9.

I would definitely love to have a public API for this.
Would `PyErr_GetTopmostException` be a good candidate for this?
(I can open a different bug report if needed)

New changeset 8963a7f1f84a05412178b56629508b660d38861b by Victor Stinner in branch 'master':
bpo-40545: Export _PyErr_GetTopmostException() function (GH-19978)
https://github.com/python/cpython/commit/8963a7f1f84a05412178b56629508b660d38861b

> I would definitely love to have a public API for this.
I'm not sure if it's a good idea. It's kind of semi-internal.
Stephan Behnel and Mark Shannon: What do you think of exposing PyThreadState exception stack (exc_state)? Especially the "top" exception. If I recall correctly, Mark designed it and Stephan "reimplemented" it in Cython.
I also recall a minor issue in greenlet:
https://github.com/python-greenlet/greenlet/pull/132 

What's wrong with `PyErr_GetExcInfo()` for accessing the current exception?
Victor, would you revert https://github.com/python/cpython/pull/19978 until we decide what to do. Thanks.

PyErr_GetExcInfo() does not allow to specify a PyThreadState as argument.

Why do you need to specify a `PyThreadState`?

> Why do you need to specify a `PyThreadState`?
From past issues, I understood that Julien's use case is a profiler which inspects memory without calling functions nor switching to other threads. It's like "dump the state of all Python threads".
I'm fine with exposing _PyErr_GetTopmostException() as a *private* function. Moreover, the function was already exposed in 3.8. It was not exposed because of the visibility change which was made in 3.9.

I confirm what Victor wrote. :)