ó mÜJ]c@`sÛdZddlmZmZmZmZddlZejeƒZ ddl m Z m Z m Z mZddlmZmZddlmZddlmZdd lmZdd lmZdZd efd „ƒYZdS(uü Provide a Bokeh Application Handler to build up documents by running the code from ``main.py`` or ``main.ipynb`` files in specified directories. The directory may also optionally contain: * A ``server_lifecyle.py`` module to provide lifecycle callbacks for the application and sessions. * A ``static`` subdirectory containing app-specific static resources to serve. * A ``theme.yaml`` file containing a Bokeh theme to automatically apply to all new documents. * A ``templates`` subdirectory containing templates for app display A full directory layout might look like: .. code-block:: none myapp | +---main.py +---server_lifecycle.py +---static +---theme.yaml +---templates +---index.html i(tabsolute_importtdivisiontprint_functiontunicode_literalsN(tbasenametdirnametexiststjoin(t EnvironmenttFileSystemLoaderi(tHandler(tNotebookHandler(t ScriptHandler(tServerLifecycleHandleruDirectoryHandlertDirectoryHandlercB`s‰eZdZd„Zed„ƒZed„ƒZed„ƒZed„ƒZd„Z d„Z d„Z d „Z d „Z d „ZRS( u? Load an application directory which modifies a Document. cO`sDtt|ƒj||Žd|kr4tdƒ‚n|d}|jdgƒ}t|dƒ}t|dƒ}t|ƒr t|ƒr tjd|ƒ|}n:t|ƒrµ|}n%t|ƒrÊ|}ntd|ƒ‚||_ ||_ |j dƒrt nt }|d |j d |ƒ|_t|d ƒ} t| ƒrd| |_td |jd |ƒ|_nd|_tƒ|_d|_t|d ƒ} t| ƒrÂd dlm} | d | ƒ|_nt|dƒ} t| ƒré| |_nd|_t|ddƒ} t| ƒr@tdtt| ƒƒƒ}|jdƒ|_ndS(uï Keywords: filename (str) : a path to an application directory with either "main.py" or "main.ipynb" argv (list[str], optional) : a list of string arguments to make available as sys.argv to main.py ufilenameu(Must pass a filename to DirectoryHandleruargvumain.pyu main.ipynbu<Found both 'main.py' and 'main.ipynb' in %s, using 'main.py'u"No 'main.py' or 'main.ipynb' in %su.ipynbtfilenametargvuserver_lifecycle.pyu theme.yamli(tThemeustaticu templatesu index.htmltloaderN(tsuperRt__init__t ValueErrortgetRRtlogtwarningt_patht_maintendswithR R t _main_handlert _lifecycleR t_lifecycle_handlertNoneR t_themet bokeh.themesRt_statict _templateRR Rt get_template(tselftargstkwargstsrc_pathRtmain_pytmain_ipytmainthandlert lifecyclet themeyamlRt appstatictappindextenv((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyRSsL                   cC`s|jjp|jjS(uE If the handler fails, may contain a related error message. (RterrorR(R%((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR2ŒscC`s|jjp|jjS(uJ If the handler fails, may contain a traceback or other details. (Rt error_detailR(R%((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR3“scC`s|jjp|jjS(u; ``True`` if the handler failed to modify the doc (RtfailedR(R%((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR4šscC`s |jjS(u® Whether it is still safe for the Bokeh server to fork new workers. ``False`` if the configured code (script, notebook, etc.) has already been run. (Rt safe_to_fork(R%((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR5¡scC`s`|jjrdS|jdk r.|j|_n|jdk rL|j|_n|jj|ƒdS(u Execute the configured ``main.py`` or ``main.ipynb`` to modify the document. This method will also search the app directory for any theme or template files, and automatically configure the document with them if they are found. N( RR4R RtthemeR#ttemplateRtmodify_document(R%tdoc((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR8­s cC`s|jj|ƒS(u¾ Execute `on_server_unloaded`` from ``server_lifecycle.py`` (if it is defined) when the server is first started. Args: server_context (ServerContext) : (Rton_server_loaded(R%tserver_context((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR:ÃscC`s|jj|ƒS(um Execute ``on_server_unloaded`` from ``server_lifecycle.py`` (if it is defined) when the server cleanly exits. (Before stopping the server's ``IOLoop``.) Args: server_context (ServerContext) : .. warning:: In practice this code may not run, since servers are often killed by a signal. (Rton_server_unloaded(R%R;((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR<ÍscC`s|jj|ƒS(u¾ Execute ``on_session_created`` from ``server_lifecycle.py`` (if it is defined) when a new session is created. Args: session_context (SessionContext) : (Rton_session_created(R%tsession_context((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR=ÝscC`s|jj|ƒS(u¾ Execute ``on_session_destroyed`` from ``server_lifecycle.py`` (if it is defined) when a session is destroyed. Args: session_context (SessionContext) : (Rton_session_destroyed(R%R>((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyR?çscC`s"|jr dSdt|jƒSdS(ud The last path component for the basename of the path to the configured directory. u/N(R4RRR(R%((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyturl_pathñs (t__name__t __module__t__doc__RtpropertyR2R3R4R5R8R:R<R=R?R@(((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyRNs 9   (uDirectoryHandler(RCt __future__RRRRtloggingt getLoggerRARtos.pathRRRRtjinja2RR R,R tnotebookR tscriptR tserver_lifecycleR t__all__R(((sClib/python2.7/site-packages/bokeh/application/handlers/directory.pyt$s" "