B ‹æ@\ ã@s^dZddlmZmZmZmZddlZe e¡Z ddl m Z ddl m Z dZGd d „d e ƒZdS) aY 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): # 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` é)Úabsolute_importÚdivisionÚprint_functionÚunicode_literalsNé)Ú_check_callbacké)ÚHandler)ÚFunctionHandlercs4eZdZdZ‡fdd„Zedd„ƒZdd„Z‡ZS)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): 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. cs(tt|ƒ ¡t|dƒ||_d|_dS)a§ Args: func (callable) : a function to modify and return a Bokeh Document. The function should have the form: .. code-block:: python def func(doc): # modify doc return doc and it should return the passed-in document after making any modifications in-place. )ÚdocTN)Úsuperr Ú__init__rÚ_funcÚ _safe_to_fork)ÚselfÚfunc)Ú __class__©úBlib/python3.7/site-packages/bokeh/application/handlers/function.pyr Ys zFunctionHandler.__init__cCs|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_forksszFunctionHandler.safe_to_forkcCs| |¡d|_dS)z  Execute the configured ``func`` to modify the document. After this method is first executed, ``safe_to_fork`` will return ``False``. FN)rr)rr rrrÚmodify_document~s zFunctionHandler.modify_document) Ú__name__Ú __module__Ú __qualname__Ú__doc__r ÚpropertyrrÚ __classcell__rr)rrr Ds  r )rZ __future__rrrrZloggingZ getLoggerrÚlogZutil.callback_managerrZhandlerr Ú__all__r rrrrÚs