ó mÜJ]c@`sƒdZddlmZmZmZmZddlZejeƒZ ddl m Z ddl m Z d Zd e fd „ƒYZdS( uY 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` i(tabsolute_importtdivisiontprint_functiontunicode_literalsNi(t_check_callbacki(tHandleruFunctionHandlertFunctionHandlercB`s/eZdZd„Zed„ƒZd„ZRS(u> 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. cC`s6tt|ƒjƒt|dƒ||_t|_dS(u§ 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. udocN(udoc(tsuperRt__init__Rt_functTruet _safe_to_fork(tselftfunc((sBlib/python2.7/site-packages/bokeh/application/handlers/function.pyRYs  cC`s|jS(u‹ Whether it is still safe for the Bokeh server to fork new workers. ``False`` if ``modify_doc`` has already been called. (R (R ((sBlib/python2.7/site-packages/bokeh/application/handlers/function.pyt safe_to_forksscC`s|j|ƒt|_dS(u  Execute the configured ``func`` to modify the document. After this method is first executed, ``safe_to_fork`` will return ``False``. N(R tFalseR (R tdoc((sBlib/python2.7/site-packages/bokeh/application/handlers/function.pytmodify_document~s (t__name__t __module__t__doc__RtpropertyRR(((sBlib/python2.7/site-packages/bokeh/application/handlers/function.pyRDs  (uFunctionHandler(Rt __future__RRRRtloggingt getLoggerRtlogtutil.callback_managerRthandlerRt__all__R(((sBlib/python2.7/site-packages/bokeh/application/handlers/function.pyts"