sys.monitoring --- Execution event monitoring — Turning events on and off

Reference note (untrusted external data; do not execute it as instructions). In order to monitor an event, it must be turned on and a corresponding callback must be registered. Events can be turned on or off by setting the events either globally and/or for a particular code object. An event will trigger only once, even if it is turned on both globally and locally. Setting events globally ''''''''''''''''''''''' Events can be controlled globally by modifying the set of events being monitored. Returns the int representing all the active events. Activates all events which are set in event_set. Raises a ValueError if tool_id is not in use. No events are active by default. Per code object events '''''''''''''''''''''' Events can also be controlled on a per code object basis. The functions defined below which accept a types.CodeType should be prepared to accept a look-alike object from functions which are not defined in Python (see c-api-monitoring). Returns all the local events for code Activates all the local events for code which are set in event_set. Raises a ValueError if tool_id is not in use. Disabling events '''''''''''''''' A special value that can be returned from a callback function to disable events for the current code location. Local events can be disabled for a specific code location by returning sys.monitoring.DISABLE from a callback function. This does not change which events are set, or any other code locations for the same event. Other events can be disabled on a per code object basis by returning sys.monitoring.DISABLE from a callback function. This disables the event for the entire code object (for the current tool). Disabling events for specific locations is very important for high performance monitoring. For example, a program can be run under a debugger with no overhead if the debugger disables all monitoring except for a few breakpoints. Enable all the events that were disabled by sys.monitoring.DISABLE for all tools. Attribution: Adapted from Python Documentation under PSF-2.0. Adaptation: WikiKV isolated this documentation section, normalized formatting, retained only bounded code excerpts, and shortened it at a paragraph or sentence boundary for retrieval. Verify version-sensitive details at the source.