ó mÜJ]c@`sdZddlmZmZmZmZddlZejeƒZ ddl m Z m Z m Z ddlmZddlmZddlmZdd lmZdd lmZdZdefd„ƒYZdee ƒfd„ƒYZdee ƒfd„ƒYZdS(uÙ 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. i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tABCMetatabstractmethodtabstractproperty(tgeni(tDocument(tsettings(twith_metaclass(tyield_for_all_futuresu Applicationu ServerContextuSessionContextt ApplicationcB`sªeZdZeZd„Zed„ƒZed„ƒZed„ƒZ ed„ƒZ d„Z d„Z d„Z d „Zd „Zejd „ƒZejd „ƒZRS( u: An Application is a factory for Document instances. cO`sx|jddƒ}|r;tdt|jƒƒdƒ‚nd|_g|_||_x|D]}|j|ƒq]WdS(u? 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. umetadatauInvalid keyword argument: %siN( tpoptNonet TypeErrortlisttkeyst _static_patht _handlerst _metadatatadd(tselfthandlerstkwargstmetadatath((s<lib/python2.7/site-packages/bokeh/application/application.pyt__init__Hs    cC`s t|jƒS(uL The ordered list of handlers this Application is configured with. (ttupleR(R((s<lib/python2.7/site-packages/bokeh/application/application.pyRpscC`s|jS(uO Arbitrary user-supplied metadata to associate with this application. (R(R((s<lib/python2.7/site-packages/bokeh/application/application.pyRwscC`std„|jDƒƒS(u cs`s|]}|jVqdS(N(t safe_to_fork(t.0thandler((s<lib/python2.7/site-packages/bokeh/application/application.pys ƒs(tallR(R((s<lib/python2.7/site-packages/bokeh/application/application.pyR~scC`s|jS(uI Path to any (optional) static resources specified by handlers. (R(R((s<lib/python2.7/site-packages/bokeh/application/application.pyt static_path…scC`s’|jj|ƒtd„|jDƒƒ}|jdƒt|ƒdkratdt|ƒƒ‚n-t|ƒdkr…|j ƒ|_ n d|_ dS(uÄ Add a handler to the pipeline used to initialize new documents. Args: handler (Handler) : a handler for this Application to use to process Documents cs`s|]}|jƒVqdS(N(R!(RR((s<lib/python2.7/site-packages/bokeh/application/application.pys ™siu/More than one static path requested for app: %rN( RtappendtsetRtdiscardRtlent RuntimeErrorRR R(RRt static_paths((s<lib/python2.7/site-packages/bokeh/application/application.pyRŽs cC`stƒ}|j|ƒ|S(uO Creates and initializes a document using the Application's handlers. (Rtinitialize_document(Rtdoc((s<lib/python2.7/site-packages/bokeh/application/application.pytcreate_document¢s  cC`sfxF|jD];}|j|ƒ|jr tjd||j|jƒq q Wtjƒrb|jƒndS(uD Fills in a new document using the Application's handlers. u,Error running application handler %r: %s %s N( Rtmodify_documenttfailedtlogterrort error_detailR tperform_document_validationtvalidate(RR)R((s<lib/python2.7/site-packages/bokeh/application/application.pyR(ªs   # cC`s%x|jD]}|j|ƒq WdS(uÉ 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(Rton_server_loaded(Rtserver_contextR((s<lib/python2.7/site-packages/bokeh/application/application.pyR2¹scC`s%x|jD]}|j|ƒq WdS(u{ 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(Rton_server_unloaded(RR3R((s<lib/python2.7/site-packages/bokeh/application/application.pyR4Ãs cc`sAx+|jD] }|j|ƒ}t|ƒVq Wtjdƒ‚dS(u7 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(Rton_session_createdR RtReturnR(Rtsession_contextRtresult((s<lib/python2.7/site-packages/bokeh/application/application.pyR5Òs cc`sAx+|jD] }|j|ƒ}t|ƒVq Wtjdƒ‚dS(u 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(Rton_session_destroyedR RR6R(RR7RR8((s<lib/python2.7/site-packages/bokeh/application/application.pyR9âs (t__name__t __module__t__doc__tTruet_is_a_bokeh_application_classRtpropertyRRRR!RR*R(R2R4Rt coroutineR5R9(((s<lib/python2.7/site-packages/bokeh/application/application.pyR =s (    t ServerContextcB`sweZdZed„ƒZed„ƒZed„ƒZed„ƒZed„ƒZ ed„ƒZ ed„ƒZ RS(u­ A harness for server-specific information and tasks related to collections of Bokeh sessions. *This base class is probably not of interest to general users.* cC`sdS(ux ``SessionContext`` instances belonging to this application. *Subclasses must implement this method.* N((R((s<lib/python2.7/site-packages/bokeh/application/application.pytsessionsûscC`sdS(uÚ Add a callback to be run on the next tick of the event loop. *Subclasses must implement this method.* Args: callback (callable) : a callback to add The callback will execute on the next tick of the event loop, and should have the form ``def callback()`` (i.e. it should not accept any arguments) Returns: an ID that can be used with ``remove_next_tick_callback``. N((Rtcallback((s<lib/python2.7/site-packages/bokeh/application/application.pytadd_next_tick_callbackscC`sdS(uX Add a callback to be run periodically until it is removed. *Subclasses must implement this method.* Args: callback (callable) : a callback to add The callback will execute periodically on the event loop as specified, and should have the form ``def callback()`` (i.e. it should not accept any arguments) period_milliseconds (int) : number of milliseconds to wait between executing the callback. Returns: an ID that can be used with ``remove_periodic_callback``. N((RRCtperiod_milliseconds((s<lib/python2.7/site-packages/bokeh/application/application.pytadd_periodic_callbackscC`sdS(u^ Add a callback to be run once after timeout_milliseconds. *Subclasses must implement this method.* Args: callback (callable) : a callback to add The callback will execute once on the event loop after the timeout has passed, and should have the form ``def callback()`` (i.e. it should not accept any arguments) timeout_milliseconds (int) : number of milliseconds to wait before executing the callback. Returns: an ID that can be used with ``remove_timeout_callback``. N((RRCttimeout_milliseconds((s<lib/python2.7/site-packages/bokeh/application/application.pytadd_timeout_callback/scC`sdS(uç Remove a callback added with ``add_next_tick_callback``, before it runs. *Subclasses must implement this method.* Args: callback_id : the ID returned from ``add_next_tick_callback`` N((Rt callback_id((s<lib/python2.7/site-packages/bokeh/application/application.pytremove_next_tick_callbackEs cC`sdS(uÍ Removes a callback added with ``add_periodic_callback``. *Subclasses must implement this method.* Args: callback_id : the ID returned from ``add_periodic_callback`` N((RRI((s<lib/python2.7/site-packages/bokeh/application/application.pytremove_periodic_callbackRs cC`sdS(uâ Remove a callback added with ``add_timeout_callback``, before it runs. *Subclasses must implement this method.* Args: callback_id : the ID returned from ``add_timeout_callback`` N((RRI((s<lib/python2.7/site-packages/bokeh/application/application.pytremove_timeout_callback^s ( R:R;R<RRBRRDRFRHRJRKRL(((s<lib/python2.7/site-packages/bokeh/application/application.pyRAñs   tSessionContextcB`sSeZdZd„Zed„ƒZed„ƒZed„ƒZe d„ƒZ RS(už A harness for server-specific information and tasks related to Bokeh sessions. *This base class is probably not of interest to general users.* cC`s||_||_dS(u N(t_server_contextt_id(RR3t session_id((s<lib/python2.7/site-packages/bokeh/application/application.pyRss cC`sdS(u¿ If ``True``, the session has been discarded and cannot be used. A new session with the same ID could be created later but this instance will not come back to life. N((R((s<lib/python2.7/site-packages/bokeh/application/application.pyt destroyed|scC`s|jS(uF The unique ID for the session associated with this context. (RO(R((s<lib/python2.7/site-packages/bokeh/application/application.pytid†scC`s|jS(u6 The server context for this session context (RN(R((s<lib/python2.7/site-packages/bokeh/application/application.pyR3scC`sdS(u Runs a function with the document lock held, passing the document to the function. *Subclasses must implement this method.* Args: func (callable): function that takes a single parameter (the Document) and returns ``None`` or a ``Future`` Returns: a ``Future`` containing the result of the function N((Rtfunc((s<lib/python2.7/site-packages/bokeh/application/application.pytwith_locked_document–s( R:R;R<RRRQR?RRR3RRT(((s<lib/python2.7/site-packages/bokeh/application/application.pyRMks    (u Applicationu ServerContextuSessionContext(R<t __future__RRRRtloggingt getLoggerR:R-tabcRRRttornadoRtdocumentRR t util.futureR t util.tornadoR t__all__tobjectR RARM(((s<lib/python2.7/site-packages/bokeh/application/application.pyts"  ´z