U õÕ/enã@s|dZddlmZddlZe e¡ZddlmZddl m Z ddl m Z dd l mZmZd Zee gdfZGd d „d eƒZdS) a` Provide a Bokeh Application Handler to build up documents by running a specified Python function. This Handler is not used by the Bokeh server command line tool, but is often useful if users wish to embed the Bokeh server programmatically: .. code-block:: python def make_doc(doc: Document): # do work to modify the document, add plots, widgets, etc. return doc app = Application(FunctionHandler(make_doc)) server = Server({'/bkapp': app}, io_loop=IOLoop.current()) server.start() For complete examples of this technique, see :bokeh-tree:`examples/howto/server_embed` é)Ú annotationsN)ÚCallableé)ÚDocument)Ú_check_callbacké)ÚHandlerÚhandle_exception)ÚFunctionHandlercsleZdZUdZded<ded<ded<ddœddd d œ‡fd d „Zedd œdd„ƒZdd dœdd„Z‡Z S)r a` A Handler that accepts a plain python function to use for modifying Bokeh Documents. For example, the following code configures a handler with a function that adds an empty plot to a Document: .. code-block:: python def add_empty_plot(doc: Document): p = figure(x_range=(0, 10), y_range=(0, 10)) doc.add_root(p) return doc handler = FunctionHandler(add_empty_plot) This handler could be configured on an Application, and the Application would run this function every time a new session is created. .. autoclasstoc:: Ú ModifyDocÚ_funcÚboolÚ_trap_exceptionsÚ _safe_to_forkF)Útrap_exceptionsÚNone)ÚfuncrÚreturncs*tƒ ¡t|dƒ||_||_d|_dS)a0 Args: func (callable) : a function to modify and return a Bokeh Document. The function should have the form: .. code-block:: python def func(doc: Document): # modify doc return doc and it should return the passed-in document after making any modifications in-place. trap_exceptions (bool) : should exceptions in `func` be caught and logged or allowed to propagate )ÚdocTN)ÚsuperÚ__init__rr rr)Úselfrr©Ú __class__©úG/tmp/pip-unpacked-wheel-f5fndrjf/bokeh/application/handlers/function.pyr^s   zFunctionHandler.__init__)rcCs|jS)z‹ Whether it is still safe for the Bokeh server to fork new workers. ``False`` if ``modify_doc`` has already been called. )r)rrrrÚ safe_to_fork|szFunctionHandler.safe_to_forkr)rrc CsXzJz| |¡Wn6tk rF}z|jr4t||ƒn‚W5d}~XYnXW5d|_XdS)z  Execute the configured ``func`` to modify the document. After this method is first executed, ``safe_to_fork`` will return ``False``. FN)rr Ú Exceptionrr )rrÚerrrÚmodify_document‡s zFunctionHandler.modify_document) Ú__name__Ú __module__Ú __qualname__Ú__doc__Ú__annotations__rÚpropertyrrÚ __classcell__rrrrr Cs  r )r#Ú __future__rÚloggingÚ getLoggerr ÚlogÚtypingrÚdocumentrZutil.callback_managerrÚhandlerrr Ú__all__r r rrrrÚs