U -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).0nrrT/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/IPython/core/events.py (sz)EventManager.__init__..N)shell callbacks)selfr available_eventsrrr__init__s zEventManager.__init__cCsFt|std|t|}||j|krB|j|||dS)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 appendZadapt)r eventfunctioncallback_protorrrregister*s   zEventManager.registerc Cs|||j|kr|j||S|j|D]>}z$|j|krN|j||WSWq(tk rdYq(Xq(td||dS)z'Remove a callback from the given event.z0Function {!r} is not registered as a {} callbackN)r remove __wrapped__AttributeError ValueErrorformat)r rrcallbackrrr unregisterBs zEventManager.unregisterc Os^|j|ddD]F}z|||Wqttfk rVtd|||jYqXqdS)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 rargskwargsfuncrrrtriggerQs zEventManager.triggerN)__name__ __module__ __qualname____doc__r rrr$rrrrrs   rcCst|}|t|j<|S)N)rr r%)Zcallback_functionrrrr _define_eventas r)cCsdS)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_executemsr*cCsdS)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_cellvs r,cCsdS)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_executesr-cCsdS)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_cells r/cCsdS)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 r1N) r(Zbackcallrobjectrr r)r*r,r-r/r1rrrrs L