mJ]c@`scdZddlmZmZmZmZddlZejeZ dZ de fdYZ dS(u Provide a base class for Bokeh Application handler classes. 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. Below is an example outline of a custom handler that might modify documents based off information in some database: .. code-block:: python class DatabaseHandler(Handler): """ A Bokeh Application handler to initialize Documents from a database """ def modify_document(self, doc): # do some data base lookup here to generate 'plot' # add the plot to the document (i.e modify the document) doc.add_root(plot) # and return it return doc i(tabsolute_importtdivisiontprint_functiontunicode_literalsNuHandlertHandlercB`seZdZdZedZedZedZdZdZ dZ dZ d Z d Z d ZRS( uW Provide a mechanism for Bokeh applications to build up new Bokeh Documents. cO`s(t|_d|_d|_d|_dS(N(tFalset_failedtNonet_errort _error_detailt_static(tselftargstkwargs((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyt__init__Ns   cC`s|jS(uE If the handler fails, may contain a related error message. (R(R ((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyterrorVscC`s|jS(uJ If the handler fails, may contain a traceback or other details. (R (R ((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyt error_detail]scC`s|jS(u; ``True`` if the handler failed to modify the doc (R(R ((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pytfaileddscC`stddS(u Modify an application document in a specified manner. 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 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. *Subclasses must implement this method* Args: doc (Document) : A Bokeh Document to update in-place Returns: Document uimplement modify_document()N(tNotImplementedError(R tdoc((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pytmodify_documentmscC`sdS(u. Execute code when the server is first started. Subclasses may implement this method to provide for any one-time initialization that is necessary after the server starts, but before any sessions are created. Args: server_context (ServerContext) : N((R tserver_context((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyton_server_loadeds cC`sdS(u Execute code when the server cleanly exits. (Before stopping the server's ``IOLoop``.) Subclasses may implement this method to provide for any one-time tear down that is necessary before the server exits. Args: server_context (ServerContext) : .. warning:: In practice this code may not run, since servers are often killed by a signal. N((R R((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyton_server_unloadedscC`sdS(u# Execute code when a new session is created. Subclasses may implement this method to provide for any per-session initialization that is necessary before ``modify_doc`` is called for the session. Args: session_context (SessionContext) : N((R tsession_context((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyton_session_createds cC`sdS(u Execute code when a session is destroyed. Subclasses may implement this method to provide for any per-session tear-down that is necessary when sessions are destroyed. Args: session_context (SessionContext) : N((R R((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyton_session_destroyeds cC`s|jr dS|jSdS(uI Return a path to app-specific static resources, if applicable. N(RRR (R ((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyt static_paths cC`sdS(uR Returns a default URL path, if applicable. Handlers subclasses may optionally implement this method, to inform the Bokeh application what URL it should be installed at. If multiple handlers specify ``url_path`` the Application will use the value from the first handler in its list of handlers. N(R(R ((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyturl_paths (t__name__t __module__t__doc__RtpropertyRRRRRRRRRR(((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyRGs    (uHandler( Rt __future__RRRRtloggingt getLoggerRtlogt__all__tobjectR(((sAlib/python2.7/site-packages/bokeh/application/handlers/handler.pyt#s "