MhvZ2dZddlmZddlZddlZddlZddlZddlm Z m Z ddl m Z m Z ddlmZddlmZddlmZmZmZmZmZmZmZdd lmZdd lmZdd lmZdd l m!Z!m"Z"d dl#m$Z$dZ%dZ&GddeZ'Gdde(Z)Gdde Z*dS)zAn extension application.) annotationsN) EnvironmentFileSystemLoader) JupyterAppNoStart) LogFormatter)RedirectHandler)AnyBoolDict HasTraitsListUnicodedefault)Config) ServerApp)_i18n)is_namespace_package url_path_join)ExtensionHandlerMixinct|dkrdS|jrjt|dkrY|d|dd}}tjd|r4||jvr-|}||||jSdSdSdSdS)z.Preparse command line to look for subcommands.rNrz ^\w(\-?\w)*$)len subcommandsrematchinitialize_subcommandsubapp)application_klassargvsubcsubargvapps d/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/jupyter_server/extension/application.py_preparse_for_subcommandr%s 4yyA~~t$TQQabbg 8OT * * t7H7T/T/T##%%C  % %dG 4 4 4:   /T/Tc |d|dn#t$r|YnwxYwtfddDr6|}|dv|ddvsdvr3|}||dd vr5|}||ddSdS) a@Looks for 'help', 'version', and 'generate-config; commands in command line. If found, raises the help and version of current Application. This is useful for traitlets applications that have to parse the command line multiple times, but want to control when when 'help' and 'version' is raised. Nz--c3 K|]}|vV dSN).0xinterpreted_argvs r$ z/_preparse_for_stopping_flags..@s) I IQ1 I I I I I Ir&)z-h --help-allz--helpr/rz --versionz-Vz--generate-config)index ValueErrorany print_helpexit print_versionwrite_default_config)rr r#r-s @r$_preparse_for_stopping_flagsr7-s=  2$**T"2"2 23      I I I I*H I I III!! |'77888  &&&$2B*B*B!!   ...!!   """  /.s ! 00ceZdZdZeeddZej dZ dS)ExtensionAppJinjaMixinzAUse Jinja templates for HTML templates on top of an ExtensionApp.z;Options to pass to the jinja2 environment for this helpTconfigc\|t|jdkr)|j|jd|jit dt|jdgdd|j|_ |j|jd|j idS) z$Get templates defined in a subclass.r_template_pathszjinja2.ext.i18nT)loader extensions autoescape _jinja2_envNr*) initialize_templatesrtemplate_pathssettingsupdatenamerrjinja2_options jinja2_envselfs r$_prepare_templatesz)ExtensionAppJinjaMixin._prepare_templates\s !!### t" # #a ' ' M TY"?"?"?AT!U V V V& #D$788)*  !    777IJJJJJr&N) __name__ __module__ __qualname____doc__r rtagrIt no_type_checkrMr*r&r$r9r9RszKKT U     cc _KK_KKKr&r9ceZdZdZdS)JupyterServerExtensionExceptionz9Exception class for raising for Server extensions errors.N)rNrOrPrQr*r&r$rVrVusCCCCr&rVceZdZUdZdZiZded<eddZ e dd Z e d Z dZd ed <ed ZedZdZedZe ddZedZedZegZeZded<e ddZeZe ddZe ddZ eddZ!e ddZ"e#eddZ$e#ee%ddZ&e'e%d dZ(e#e%d!dZ)d"ed#<d$Z*d%Z+d&Z,d'Z-d(Z.d)Z/d*Z0d+Z1d,Z2d?d0Z3d1Z4fd2Z5d3Z6d4Z7d5Z8ed6Z9d7Z:ed8Z;eZedBd>Z?xZ@S)C ExtensionAppaBase class for configurable Jupyter Server Extension Applications. ExtensionApp subclasses can be initialized two ways: - Extension is listed as a jpserver_extension, and ServerApp calls its load_jupyter_server_extension classmethod. This is the classic way of loading a server extension. - Extension is launched directly by calling its `launch_instance` class method. This method can be set as a entry_point in the extensions setup.py. Tzdict[str, t.Any]serverapp_configaWhether to open in a browser after starting. The specific browser used is platform dependent and determined by the python standard library `webbrowser` module, unless it is overridden using the --browser (ServerApp.browser) configuration option. r:r< open_browserc`|jJ|jjdddS)NrrZT) serverappr=getrKs r$_default_open_browserz"ExtensionApp._default_open_browsers0~)))~$[155ndKKKr&c,|jJ|jjS)z4Look on the same path as our parent for config files)r\config_file_pathsrKs r$r`zExtensionApp.config_file_pathss~)))~//r&zstr | Unicode[str, str]rHc|jd}t|drd|ddS|dS)zGet an extension package..r)rOsplitrjoin)clspartss r$get_extension_packagez"ExtensionApp.get_extension_packagesP$$S)) a ) ) (88E!A#J'' 'Qxr&c|jS)zGet an extension point.)rO)rfs r$get_extension_pointz ExtensionApp.get_extension_points ~r&/ default_urlc|jSr)) extension_urlrKs r$ _default_urlzExtensionApp._default_urls !!r& notebooksFzServerApp | Noner\ctjr$ tjS#t$rYnwxYwtSr))r initializedinstance ExceptionrKs r$_default_serverappzExtensionApp._default_serverappsU  " "   )+++     {{s ( 55 log_levelctjSr))loggingINFOrKs r$_default_log_levelzExtensionApp._default_log_levels |r& log_formatc dS)z2override default log format to include date & timezV%(color)s[%(levelname)1.1s %(asctime)s.%(msecs).03d %(name)s]%(end_color)s %(message)sr*rKs r$_default_log_formatz ExtensionApp._default_log_formats e  r&z9Url where the static assets for the extension are served.static_url_prefixc^d|jd}|jJt|jj|S)Nzstatic/rk)rHr\rbase_url)rL static_urls r$_default_static_url_prefixz'ExtensionApp._default_static_url_prefixs7+ty+++ ~)))T^4jAAAr&zpaths to search for serving static files. This allows adding javascript/css to be available from the notebook server machine, or overriding individual files in the IPython zpPaths to search for serving jinja templates. Can be used to override templates from notebook.templates.z(Settings that will passed to the server.z Handlers appended to the server.zList[tuple[t.Any, ...]]handlerscp|jsdSd|jddS)zThe default config file name.zjupyter_{}_config-_)rHformatreplacerKs r$_config_file_name_defaultz&ExtensionApp._config_file_name_defaults7y 2"))$)*;*;C*E*EFFFr&cdS)z1Override this method to add handling of settings.Nr*rKs r$initialize_settingsz ExtensionApp.initialize_settingsr&cdS)z_config`. c2i|]}|t|Sr*)getattr)r+rSrLs r$ z0ExtensionApp._prepare_config..)s%'L'L'L74+;+;'L'L'Lr&_configN)class_own_traitskeysrextension_configrFrH)rLtraitss` r$_prepare_configzExtensionApp._prepare_config$sg&&((--// &'L'L'L'LV'L'L'L M M/3/D +++,,,r&c|jJ|jj}|jjdi|j|j|jd|j|j|i||jjdi|jdS)zPrepare the settings.N _static_pathsr*)r\web_apprFrGrH static_pathsr)rLwebapps r$_prepare_settingszExtensionApp._prepare_settings,s~)))' //v/// 9+++T->9       """ ///////r&cp|jJ|jj}|g}|jD]}t |jd|d}|d}i}t |tr |j|d< | |dn#t$rYnwxYw|||f}| |t|j dkrAt |jd}||jdd |j if}| ||d |dS) zPrepare the handlers.NrrrrHrcz(.*)static_handler_classpathz.*$)r\rrrrrF issubclassrrHrG IndexErrorappendrrr~ add_handlers) rLr new_handlers handler_itemspatternhandlerkwargs new_handlerrs r$_prepare_handlerszExtensionApp._prepare_handlersAsr~)))'   """ !] - -M#FOJ$?qAQRRG#A&G(*F'#899 +!%v  mA.////    #GV4K    , , , , t ! !A % %&t'=vFFJ 67*+G    ( ( (E<00000sB B)(B)ct|jdkr)|j|jd|ji|dS)z=Add templates to web app settings if extension has templates.rr?N)rrErFrGrHrDrKs r$rMzExtensionApp._prepare_templateslsY t" # #a ' ' M TY"?"?"?AT!U V V V !!#####r&ctd|j|j|jdi}|d|j|S)zThe jupyter server config.r)rlrZfile_url_prefix)rlrZrrGrY)rL base_configs r$_jupyter_server_configz#ExtensionApp._jupyter_server_configrsN #/ $ 1#'#7  K ''(=>>>r&rreturnNonec||_|||jj||jj|j|jd|_dS)aLink the ExtensionApp to an initialized ServerApp. The ServerApp is stored as an attribute and config is exchanged between ServerApp and `self` in case the command line contains traits for the ExtensionApp or the ExtensionApp's config files have server settings. Note, the ServerApp has not initialized the Tornado Web Application yet, so do not try to affect the `web_app` attribute. TN)r\load_config_file update_configr=parse_command_line extra_args_linkedrLr\s r$_link_jupyter_server_extensionz+ExtensionApp._link_jupyter_server_extension~sx#  4>0111  9::: $$T[111 r&c|jsd}t|||||dS)aXInitialize the extension app. The corresponding server app and webapp should already be initialized by this step. - Appends Handlers to the ServerApp, - Passes config and settings from ExtensionApp to the Tornado web application - Points Tornado Webapp to templates and static assets. zoThis extension has no attribute `serverapp`. Try calling `.link_to_serverapp()` before calling `.initialize()`.N)r\rVrrMrr)rLmsgs r$ initializezExtensionApp.initializesv~ 7#  2#66 6  !!!          r&ct|jJ|jdS)zoStart the underlying Jupyter server. Server should be started after extension is initialized. N)superstartr\)rL __class__s r$rzExtensionApp.starts>  ~))) r&cdS)z6Return a list of activity happening in this extension.Nr*rKs r$current_activityzExtensionApp.current_activitysr&c KdS)z0Cleanup any resources managed by this extension.Nr*rKs r$stop_extensionzExtensionApp.stop_extension r&c||jJ|j|jdS)z#Stop the underlying Jupyter server.N)r\stopclear_instancerKs r$rzExtensionApp.stops>~)))  %%'''''r&c|j} |j|j}|j}n/#t$r"|}||YnwxYw||S)zInitialize and configure this extension, then add the extension's settings and handlers to the server's web application. )extension_managerextension_pointsrHr#KeyErrorrr)rfr\rpoint extensions r$_load_jupyter_server_extensionz+ExtensionApp._load_jupyter_server_extensions &7 @%6sx@E II @ @ @I  4 4Y ? ? ? ? ? @ s#)AAc KdS)a: An async hook to start e.g. tasks from the extension after the server's event loop is running. Override this method (no need to call `super()`) to start (async) tasks from an extension. This is useful for starting e.g. background tasks from an extension. Nr*rs r$_start_jupyter_server_extensionz,ExtensionApp._start_jupyter_server_extensionrr&c|}||_|||j||j|jdtdt|j difdtdt|j difdtdt|j difdtdt|j d ifd tdt|j d ifd tdt|j d ifdtdt|j difdtdt|j difg| dS)zPEnables extension to be loaded as classic Notebook (jupyter/notebook) extension.z/static/favicons/favicon.icourlzstatic/base/images/favicon.icoz#/static/favicons/favicon-busy-1.icoz%static/base/images/favicon-busy-1.icoz#/static/favicons/favicon-busy-2.icoz%static/base/images/favicon-busy-2.icoz#/static/favicons/favicon-busy-3.icoz%static/base/images/favicon-busy-3.icoz!/static/favicons/favicon-file.icoz#static/base/images/favicon-file.icoz%/static/favicons/favicon-notebook.icoz'static/base/images/favicon-notebook.icoz%/static/favicons/favicon-terminal.icoz'static/base/images/favicon-terminal.icoz/static/logo/logo.pngzstatic/base/images/logo.pngN) r\rrr=rrrextendr rrr)rfr\rs r$load_classic_server_extensionz*ExtensionApp.load_classic_server_extensionsCEE ' ""$$$ 0111$$Y%9:::!!4#M)*<>^__` ;#}%.0W  ;#}%.0W  ;#}%.0W  9#}%.0U  =#}%.E   =#}%.E   -#M)*<>[\\]}C E E E L r&rt.Anyc &|jjdi|S)zqInstantiate the ServerApp Override to customize the ServerApp before it loads any configuration r*)serverapp_classrs)rfrs r$make_serverappzExtensionApp.make_serverapp=s ,s"+55f555r&Nc D|di}|j}d|jvr,||jd||jd<d}|jdd|i|}|j|j||pg|j||S)a Creates an instance of ServerApp and explicitly sets this extension to enabled=True (i.e. superseding disabling found in other config from files). The `launch_instance` method uses this method to initialize and start a server. Tjpserver_extensionsF)r starter_extensionfind_extensionsr*)rhload_other_extensionsrYrGraliasesrrH)rfr rrrrr\s r$initialize_serverzExtensionApp.initialize_serverEs #88::DA3 C$8 8 8  & &s';rs"""""" 0000000088888888$$$$$$''''''HHHHHHHHHHHHHHHHHH######......++++++DDDDDDDD******""""JKKKKKYKKKFDDDDDiDDD:r&