o œ©Zhƒã@s`dZGdd„deƒZiZdd„Zedd„ƒZedd„ƒZed d „ƒZed d „ƒZed d„ƒZ 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. c@s2eZdZdZd dd„Zdd„Zdd„Zd d „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. TcCs ||_dd„|Dƒ|_||_dS)a…Initialise the :class:`CallbackManager`. Parameters ---------- shell The :class:`~IPython.core.interactiveshell.InteractiveShell` instance available_events An iterable of names for callback events. print_on_error: A boolean flag to set whether the EventManager will print a warning which a event errors. cSsi|]}|g“qS©r)Ú.0ÚnrrúJ/var/www/html/lang_env/lib/python3.10/site-packages/IPython/core/events.pyÚ )sz)EventManager.__init__..N)ÚshellÚ callbacksÚprint_on_error)ÚselfrÚavailable_eventsr rrrÚ__init__s  zEventManager.__init__cCs:t|ƒs td|ƒ‚||j|vr|j| |¡dSdS)aïRegister 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Úappend©r ÚeventÚfunctionrrrÚregister,s  ÿzEventManager.registercCs.||j|vr|j| |¡Std ||¡ƒ‚)z'Remove a callback from the given event.z0Function {!r} is not registered as a {} callback)rÚremoveÚ ValueErrorÚformatrrrrÚ unregisterCszEventManager.unregisterc Osh|j|dd…D](}z ||i|¤ŽWq ttfy1|jr*td ||||¡ƒ|j ¡Yq wdS)zÉCall 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. Nz@Error in callback {} (for {}), with arguments args {},kwargs {}:)rÚ ExceptionÚKeyboardInterruptr ÚprintrrÚ showtraceback)r rÚargsÚkwargsÚfuncrrrÚtriggerJsÿÿùýzEventManager.triggerN)T)Ú__name__Ú __module__Ú __qualname__Ú__doc__r rrrrrrrrs   rcCs|t|j<|S)N)r r )Zcallback_functionrrrÚ _define_event_s r$cCódS)z©Fires 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_executejór&cCr%)zÏFires 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_cellsó r)cCr%)z¨Fires 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_execute~r'r+cCr%)zÏFires 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_cell‡r*r-cCr%)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)ÚiprrrÚshell_initialized’s r/N) r#Úobjectrr r$r&r)r+r-r/rrrrÚsL