gh-142186: make PY_UNWIND available as a local event

[P403n1x87]

We make the PY_UNWIND monitoring event available as a code-local event to allow trapping on function exit events when an exception bubbles up. This complements the PY_RETURN event by allowing to catch any function exit event.

Example

importrandom, sysm, e=sys.monitoring, sys.monitoring.eventsm.use_tool_id(0, "debugger")
defmonitor(event):
def_(f):
m.register_callback(0, event, f)
return_@monitor(e.PY_START)def_(*_, **__):
print("entering", sys._getframe(1))
@monitor(e.PY_UNWIND)def_(*_, **__):
print("exiting ", sys._getframe(1), "with exception")
deffoo():
raiseRuntimeError()
defbar():
returnfoo()
defbaz():
returnbar()
m.set_local_events(0, random.choice([foo, bar, baz]).__code__, e.PY_UNWIND|e.PY_START)
try:
baz()
exceptException:
pass# entering <frame at 0x101602f80, file 'test_py_unwind_local.py', line 34, code baz># exiting <frame at 0x101602f80, file 'test_py_unwind_local.py', line 35, code baz> with exception

• Issue: Make the PY_UNWIND monitoring event local #142186

[P403n1x87]

IMO all these data should be encoded in a "table", e.g.

typedefstruct_monitoring_event {
intid;
boollocal;
boolinstrumented;
char*name; // maybe
} monitoring_event_t;
monitoring_event_tMONITORING_EVENTS[] = { ... };
#definePY_MONITORING_IS_INSTRUMENTED_EVENT(ev) (MONITORING_EVENTS[ev].instrumented)

[github-actions]

This PR is stale because it has been open for 30 days with no activity.