New GitHub issue #118692 from scoder:<br>

<hr>

<pre>
# Feature or enhancement

### Proposal:

A new C-API for injecting monitoring events was discussed in https://github.com/python/cpython/issues/111997 and implemented for Py3.13 in https://github.com/python/cpython/pull/116413

A remaining issue is that signalling "STOP_ITERATION" events requires a `StopIteration` exception instance, whereas generators usually try to avoid creating one during termination to increase their performance.

I think it would be best if CPython's monitoring infrastructure created a StopIteration instance automatically when it detects that it needs to notify about it without having one. It's in the best position to detect whether it really needs an exception instance or not. Event sources shouldn't be forced to a) figure that out themselves or b) create an instance just for it to be thrown away.

CPython already creates an exception instance for submitting a monitoring event for a generator, but does so unconditionally. It would also benefit from not having to generate one unless it's really needed for signalling.

https://github.com/python/cpython/blob/52485967813acdb35c274e1b2eaedd34e9ac01fc/Python/bytecodes.c#L289-L317

Basically, we should move the existing code from the byte code handlers all the way to the other side into the notification mechanism.

In order to report the correct StopIteration value, the event creation function should accept an object value directly, and create a `StopIteration` instance for that value only if it ends up signalling it to listeners.

We might allow passing the value `NULL`  (as opposed to the object value `None`) to make the machinery look up an actually existing currently raised `StopIteration` instance. Alternatively, passing a `StopIteration` instance as value is probably also a reasonably clear indication for an instance being available already. We may also consider adding two event creation functions, one with a bare stop value and one with a readily created `StopIteration` instance.

This ticket proposes a usability/performance enhancement to a newly added feature in Py3.13, and thus does not fall under the "beta-1" release end of new features.

### Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

### Links to previous discussion of this feature:

https://github.com/python/cpython/pull/116413#issuecomment-2093689068
</pre>

<hr>

<a href="https://github.com/python/cpython/issues/118692">View on GitHub</a>
<p>Labels: type-feature, 3.13</p>
<p>Assignee: </p>