fdZddlmZGddeZiZdZedZedZedZ ed Z ed Z y ) aoInfrastructure for registering and firing callbacks on application events. Unlike :mod:`IPython.core.hooks`, which lets end users set single functions to be called at specific times, or a collection of alternative methods to try, callbacks are designed to be used by extension authors. A number of callbacks can be registered for the same event without needing to be aware of one another. The functions defined in this module are no-ops indicating the names of available events and the arguments which will be passed to them. .. note:: This API is experimental in IPython 2.0, and may be revised in future versions. )callback_prototypec(eZdZdZdZdZdZdZy) EventManagera3Manage a collection of events and a sequence of callbacks for each. This is attached to :class:`~IPython.core.interactiveshell.InteractiveShell` instances as an ``events`` attribute. .. note:: This API is experimental in IPython 2.0, and may be revised in future versions. cH||_|Dcic]}|gc}|_ycc}w)aInitialise the :class:`CallbackManager`. Parameters ---------- shell The :class:`~IPython.core.interactiveshell.InteractiveShell` instance available_events An iterable of names for callback events. N)shell callbacks)selfravailable_eventsns N/var/www/cvtools/html/venv/lib/python3.12/site-packages/IPython/core/events.py__init__zEventManager.__init__s$ (891!B$99s ct|std|ztj|}||j|vr.|j|j |j |yy)aRegister a new event callback. Parameters ---------- event : str The event for which to register this callback. function : callable A function to be called on the given event. It should take the same parameters as the appropriate callback prototype. Raises ------ TypeError If ``function`` is not callable. KeyError If ``event`` is not one of the known events. zNeed a callable, got %rN)callable TypeErrorr getrappendadapt)r eventfunctioncallback_protos r registerzEventManager.register*se$!5@A A)--e4 4>>%0 0 NN5 ! ( ()=)=h)G H 1c:||j|vr|j|j|S|j|D]1} |j|ur |j|j|cS3t dj ||#t$rYZwxYw)z'Remove a callback from the given event.z0Function {!r} is not registered as a {} callback)rremove __wrapped__AttributeError ValueErrorformat)r rrcallbacks r unregisterzEventManager.unregisterBs t~~e, ,>>%(//9 9u- H ''83>>%077AA4 KRRS[]bcdd"  s+B BBc|j|ddD] } ||i| y#ttf$r8tdj |||j j YUwxYw)zCall callbacks for ``event``. Any additional arguments are passed to all callbacks registered for this event. Exceptions raised by callbacks are caught, and a message printed. NzError in callback {} (for {}):)r ExceptionKeyboardInterruptprintrr showtraceback)r rargskwargsfuncs r triggerzEventManager.triggerQsp NN5)!, +D +d%f% +01 +6==dEJK ((* +s"AA)(A)N)__name__ __module__ __qualname____doc__r rr r)rr rrs :I0 e +rrcBt|}|t|j<|S)N)rr r*)callback_functionrs r _define_eventr1as%'(9:N3A&//0 rcy)zFires before code is executed in response to user/frontend action. This includes comm and widget messages and silent execution, as well as user code cells. Nr.r.rr pre_executer3m rcy)zFires before user-entered code runs. Parameters ---------- info : :class:`~IPython.core.interactiveshell.ExecutionInfo` An object containing information used for the code execution. Nr.)infos r pre_run_cellr7v rcy)zFires after code is executed in response to user/frontend action. This includes comm and widget messages and silent execution, as well as user code cells. Nr.r.rr post_executer:r4rcy)zFires after user-entered code runs. Parameters ---------- result : :class:`~IPython.core.interactiveshell.ExecutionResult` The object which will be returned as the execution result. Nr.)results r post_run_cellr=r8rcy)aKFires after initialisation of :class:`~IPython.core.interactiveshell.InteractiveShell`. This is before extensions and startup scripts are loaded, so it can only be set by subclassing. Parameters ---------- ip : :class:`~IPython.core.interactiveshell.InteractiveShell` The newly initialised shell. Nr.)ips r shell_initializedr@s rN) r-backcallrobjectrr r1r3r7r:r=r@r.rr rCs (I+6I+X            r