-e-RUdZddlmZddlZejeZddlmZm Z ddl m Z m Z m Z mZmZddlmZddlmZdd lmZe rdd lmZdd lmZdd lmZd dlmZdZegdfZded<GddZ GddeZ!GddeZ"ee"gdfZ#dS)a Provide the ``Application`` class. Application instances are factories for creating new Bokeh Documents. When a Bokeh server session is initiated, the Bokeh server asks the Application for a new Document to service the session. To do this, the Application first creates a new empty Document, then it passes this new Document to the ``modify_document`` method of each of its handlers. When all handlers have updated the Document, it is used to service the user session. ) annotationsN)ABCMetaabstractmethod) TYPE_CHECKINGAny AwaitableCallableClassVar)ID)Document)settings)HTTPServerRequest) TypeAlias) ServerSession)Handler) Application ServerContextSessionContextrCallbackceZdZUdZdZded<ded<ded<d ed <d d d+dZed,dZed-dZ ed.dZ ed/dZ d0dZ d1dZ d2dZd3d!Zd3d"Zd4d%Zd4d&Zd5d*Zd S)6rz: An Application is a factory for Document instances. TzClassVar[bool]_is_a_bokeh_application_class str | None _static_pathz list[Handler] _handlersdict[str, Any] | None _metadataN)metadatahandlersrrreturnNonecdd|_g|_||_|D]}||dS)a? Application factory. Args: handlers (seq[Handler]): List of handlers to call. The URL is taken from the first one only. Keyword Args: metadata (dict): arbitrary user-supplied JSON data to make available with the application. The server will provide a URL ``http://applicationurl/metadata`` which returns a JSON blob of the form: .. code-block:: json { "data": { "hi": "hi", "there": "there" }, "url": "/myapp" } The user-supplied metadata is returned as-is under the ``"data"`` key in the blob. N)rrradd)selfrr hs =lib/python3.11/site-packages/bokeh/application/application.py__init__zApplication.__init__XsD8!!  A HHQKKKK  tuple[Handler, ...]c*t|jS)zL The ordered list of handlers this Application is configured with. )tuplerr%s r'r zApplication.handlers|s T^$$$r)c|jS)zO Arbitrary user-supplied metadata to associate with this application. )rr-s r'rzApplication.metadatas ~r)boolc>td|jDS) c3$K|] }|jV dS)N) safe_to_fork).0handlers r' z+Application.safe_to_fork..s%FFG7'FFFFFFr))allrr-s r'r3zApplication.safe_to_forks# FFt~FFFFFFr)c|jS)zI Path to any (optional) static resources specified by handlers. )rr-s r' static_pathzApplication.static_paths   r)r5cT|j|d|jD}|dt |dkrt dt |zt |dkr||_dSd|_dS)z Add a handler to the pipeline used to initialize new documents. Args: handler (Handler) : a handler for this Application to use to process Documents c6h|]}|S)r9)r4r&s r' z"Application.add..s ???A ???r)Nrz/More than one static path requested for app: %r) rappendr discardlen RuntimeErrorlistpopr)r%r5 static_pathss r'r$zApplication.adds g&&&@???? T""" |  q PSWXdSeSeeff f   ! # # , 0 0 2 2D    $D   r)r cLt}|||S)zO Creates and initializes a document using the Application's handlers. )r initialize_document)r%docs r'create_documentzApplication.create_documents&jj   %%% r)rGc|jD]E}|||jr'td||j|jFt jr|dSdS)zD Fills in a new document using the Application's handlers. z,Error running application handler %r: %s %s N) rmodify_documentfailedlogerror error_detailrperform_document_validationvalidate)r%rGr&s r'rFzApplication.initialize_documents f fA   c " " "x f H!QWVWVdeee  / 1 1  LLNNNNN  r)server_contextrcD|jD]}||dS)z Invoked to execute code when a new session is created. This method calls ``on_server_loaded`` on each handler, in order, with the server context passed as the only argument. N)ron_server_loadedr%rQr&s r'rSzApplication.on_server_loadeds6 / /A  ~ . . . . / /r)cD|jD]}||dS)a{ Invoked to execute code when the server cleanly exits. (Before stopping the server's ``IOLoop``.) This method calls ``on_server_unloaded`` on each handler, in order, with the server context passed as the only argument. .. warning:: In practice this code may not run, since servers are often killed by a signal. N)ron_server_unloadedrTs r'rVzApplication.on_server_unloadeds6 1 1A  0 0 0 0 1 1r)session_contextrcTK|jD]}||d{VdS)a7 Invoked to execute code when a new session is created. This method calls ``on_session_created`` on each handler, in order, with the session context passed as the only argument. May return a ``Future`` which will delay session creation until the ``Future`` completes. N)ron_session_createdr%rWr&s r'rYzApplication.on_session_createdsG 8 8A&&77 7 7 7 7 7 7 7 7tr)cTK|jD]}||d{VdS)a Invoked to execute code when a session is destroyed. This method calls ``on_session_destroyed`` on each handler, in order, with the session context passed as the only argument. Afterwards, ``session_context.destroyed`` will be ``True``. N)ron_session_destroyedrZs r'r\z Application.on_session_destroyedsG : :A((99 9 9 9 9 9 9 9 9tr)requestrdict[str, Any]cni}|jD]*}|||+|S)a# Processes incoming HTTP request returning a dictionary of additional data to add to the session_context. Args: request: HTTP request Returns: A dictionary of JSON serializable data to be included on the session context. )rupdateprocess_request)r%r] request_datar&s r'razApplication.process_requestsE(*  < rs   #"""""g!!('''''''*222222++++++......))))))  r4x(((((~~~~~~~~B     g    (> > > > > w> > > > @$^$4d$:;r)