^hxSr"SS\5r0rSr\S5r\S5r\S5r\S5r\S5r g ) 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. c4\rSrSrSrS SjrSrSrSrSr g) EventManageraManage 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. cVXlUVs0sHoD/_M snUlX0lgs snf)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. N)shell callbacksprint_on_error)selfravailable_eventsrns M/home/james-whalen/.local/lib/python3.13/site-packages/IPython/core/events.py__init__EventManager.__init__s. (89(81B$(89,:s &c[U5(d[SU-5eX RU;aURURU5 gg)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 TypeErrorrappendr eventfunctions r registerEventManager.register,sK$!!5@A A >>%0 0 NN5 ! ( ( 2 1cX RU;aURURU5$[SRX!55e)z'Remove a callback from the given event.z0Function {!r} is not registered as a {} callback)rremove ValueErrorformatrs r unregisterEventManager.unregisterCsC ~~e, ,>>%(//9 9KRRS[cddrc URUSSH nU"U0UD6 M g![[4aJ UR(a[ SR XAX#55 UR R5 Mjf=f)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. Nz@Error in callback {} (for {}), with arguments args {},kwargs {}:)r ExceptionKeyboardInterruptrprintrr showtraceback)r rargskwargsfuncs r triggerEventManager.triggerJs{ NN5)!,D +d%f%-01 +&&Zaa   ((* +s$AA>=A>)rrrN)T) __name__ __module__ __qualname____firstlineno____doc__r rrr'__static_attributes__rr rrs- 3.e+rrc,U[UR'U$)N)r r))callback_functions r _define_eventr2_s3D&//0 rcg)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_executer4j rcg)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_cellr8s rcg)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;~r5rcg)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>r9rcg)a/Fires 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_initializedrAs rN) r-objectrr r2r4r8r;r>rAr/rr rCs  I+6I+X            r