o ˷e@sldZddlmZGdddeZiZddZeddZed d Zed d Z ed dZ eddZ dS)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@s0eZdZdZddZddZddZdd Zd S) 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. cCs||_dd|D|_dS)aInitialise the :class:`CallbackManager`. Parameters ---------- shell The :class:`~IPython.core.interactiveshell.InteractiveShell` instance available_events An iterable of names for callback events. cSsi|]}|gqSr).0nrrJ/var/www/ideatree/venv/lib/python3.10/site-packages/IPython/core/events.py (sz)EventManager.__init__..N)shell callbacks)selfr available_eventsrrr__init__s zEventManager.__init__cCsJt|s td|t|}||j|vr#|j|||dSdS)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 getr appendadapt)r eventfunctioncallback_protorrrregister*s   zEventManager.registerc Cst||j|vr|j||S|j|D]}z|j|ur'|j||WSWqty1Yqwtd||)z'Remove a callback from the given event.z0Function {!r} is not registered as a {} callback)r remove __wrapped__AttributeError ValueErrorformat)r rrcallbackrrr unregisterBs  zEventManager.unregisterc Os^|j|ddD]#}z ||i|Wq ttfy,td|||jYq wdS)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 rargskwargsfuncrrrtriggerQszEventManager.triggerN)__name__ __module__ __qualname____doc__r rrr%rrrrrs    rcCst|}|t|j<|S)N)rr r&)callback_functionrrrr _define_eventas r+cCdS)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. Nrrrrr pre_executemr-cCr,)zFires before user-entered code runs. Parameters ---------- info : :class:`~IPython.core.interactiveshell.ExecutionInfo` An object containing information used for the code execution. Nr)inforrr pre_run_cellv r0cCr,)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. Nrrrrr post_executer.r2cCr,)zFires after user-entered code runs. Parameters ---------- result : :class:`~IPython.core.interactiveshell.ExecutionResult` The object which will be returned as the execution result. Nr)resultrrr post_run_cellr1r4cCr,)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)iprrrshell_initializeds r6N) r)backcallrobjectrr r+r-r0r2r4r6rrrrs L