hje*>dZddlmZddlZejeZddlZddlm Z m Z m Z m Z ddl mZddlmZmZmZddlmZmZmZdd lmZdd lmZd d lmZmZd dlmZd dl m!Z!d dl"m#Z#d dl$m%Z%d dl&m'Z'd dl(m)Z)er ddl*m+Z+ddl,m-Z-dZ.Gdde!Z/dS)a 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 ) annotationsN)basenamedirnameexistsjoin) ModuleType) TYPE_CHECKINGAny Coroutine) EnvironmentFileSystemLoaderTemplate)PathLike)Document) ServerContextSessionContext) CodeRunner)Handler)NotebookHandler) ScriptHandler)ServerLifecycleHandler)ServerRequestHandler)HTTPServerRequestTheme)DirectoryHandlerc eZdZUdZded<ded<ded<ded<d ed <d ed <d ed<gdd-fdZed.dZed.dZed/dZ ed/dZ d0dZ d1d!Z d1d"Z d2d&Zd2d'Zd3d+Zd.d,ZxZS)4rz> Load an application directory which modifies a Document. zCodeRunner | None_package_runnerzModuleType | None_packager_lifecycle_handler_request_handlerz Theme | None_theme str | None_staticzTemplate | None _template)argvfilenamerr) list[str]returnNonect|}t|d}t|rt |d5}t ||||_dddn #1swxYwY|j|_ |j J|j tj |j j <nd|_d|_ t|d}t|d}t|r0t|r!td|d|}n6t|r|}n$t|r|}ntd |||_||_|d rt&nt(} | |j||j |_d} t|d } t|d } t| rt| rtdt| r| } nt| r| } | t-| ||j |_nt1|_t| r!| Jt3| ||j |_nt1|_d|_t|d} t| rddlm}|| |_t|d}t|r||_d|_t|dd}t|rFtAtCtE|}|#d|_dSdS)z 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 z __init__.pyutf8)encodingNzmain.pyz main.ipynbz)Found both 'main.py' and 'main.ipynb' in z, using 'main.py'z No 'main.py' or 'main.ipynb' in z.ipynb)r*r)packagez app_hooks.pyzserver_lifecycle.pyzVDirectory style apps can provide either server_lifecycle.py or app_hooks.py, not both.z theme.yamlrr)r*static templatesz index.html)loader)$super__init__rropenrreadr! new_moduler"sysmodules__name__logwarning ValueError_path_mainendswithrr _main_handlerrr#rrr$r% bokeh.themesrr'r(r r r get_template)selfr*r)src_pathinit_py init_py_fmain_pymain_ipymainhandlerhooks app_hooks lifecycle themeyamlr appstaticappindexenv __class__s Dlib/python3.11/site-packages/bokeh/application/handlers/directory.pyr6zDirectoryHandler.__init__ns x// '?? !g/// S9'1)..2B2BGT'R'R$ S S S S S S S S S S S S S S S 0;;==DM=,,,26-CK . / /#'D  DMx++,// '?? Lvh// L KK_H___ ` ` `DD G__ LDD H   LDDJJJKK K  %)]]8%<%<O//-$WdjtT][[[>22 #899 )    !2!2 uvv v I   EE I   E  & %>CL **3/////rZserver_contextrc|jr&|jr|j|j|j|S)z Execute `on_server_unloaded`` from ``server_lifecycle.py`` (if it is defined) when the server is first started. Args: server_context (ServerContext) : )r!r"runr#on_server_loadedrFrgs rVrjz!DirectoryHandler.on_server_loadedsH   4DM 4  $ $T] 3 3 3&77GGGrZc6|j|S)am 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. )r#on_server_unloadedrks rVrmz#DirectoryHandler.on_server_unloadeds&99.IIIrZsession_contextrCoroutine[Any, Any, None]c6|j|S)z Execute ``on_session_created`` from ``server_lifecycle.py`` (if it is defined) when a new session is created. Args: session_context (SessionContext) : )r#on_session_createdrFrns rVrqz#DirectoryHandler.on_session_createds&99/JJJrZc6|j|S)z Execute ``on_session_destroyed`` from ``server_lifecycle.py`` (if it is defined) when a session is destroyed. Args: session_context (SessionContext) : )r#on_session_destroyedrrs rVrtz%DirectoryHandler.on_session_destroyeds&;;OLLLrZrequestrdict[str, Any]c6|j|S)a# Processes incoming HTTP request returning a dictionary of additional data to add to the session_context. Args: request: HTTP request Returns: A dictionary of JSON serializable data to be included on the session context. )r$process_request)rFrus rVrxz DirectoryHandler.process_request$s$44W===rZcB|jrdSdt|jzS)zd The last path component for the basename of the path to the configured directory. N/)r_rr@rYs rVurl_pathzDirectoryHandler.url_path1s* ; .4$*--- -rZ)r*rr)r+r,r-)r,r&)r,r])rbrr,r-)rgrr,r-)rnrr,ro)rurr,rv)r< __module__ __qualname____doc____annotations__r6propertyrXr\r_rarfrjrmrqrtrxr{ __classcell__)rUs@rVrr`s'&&&@BJ<J<J<J<J<J<J<J<\IIIXI WWWXW KKKXK ///X/0000, H H H HJJJJ KKKKMMMM > > > > . . . . . . . .rZr)0r~ __future__rlogging getLoggerr<r=r:os.pathrrrrtypesrtypingr r r jinja2r r r core.typesrdocumentr applicationrr code_runnerrrMrnotebookrscriptrserver_lifecyclerserver_request_handlerrtornado.httputilrthemesr__all__rrZrVrsD#"""""g!!  0000000000;:::::::::#""""" 77777777######%%%%%%!!!!!!444444888888 222222  Z.Z.Z.Z.Z.wZ.Z.Z.Z.Z.rZ