^hvZSrSSKJr SSKrSSKrSSKrSSKrSSKJ r J r SSK J r J r SSKJr SSKJr SSKJrJrJrJrJrJrJr SS KJr SS KJr SS KJr SS K J!r!J"r" S SK#J$r$ Sr%Sr&"SS\5r'"SS\(5r)"SS\ 5r*g)zAn extension application.) annotationsN) EnvironmentFileSystemLoader) JupyterAppNoStart) LogFormatter)RedirectHandler)AnyBoolDict HasTraitsListUnicodedefault)Config) ServerApp)_i18n)is_namespace_package url_path_join)ExtensionHandlerMixinc[U5S:XagUR(aj[U5S:aZUSUSSp2[R"SU5(a4X R;a$U"5nUR X#5 UR $gggg)z.Preparse command line to look for subcommands.rNrz ^\w(\-?\w)*$)len subcommandsrematchinitialize_subcommandsubapp)application_klassargvsubcsubargvapps ^/home/james-whalen/.local/lib/python3.13/site-packages/jupyter_server/extension/application.py_preparse_for_subcommandr%s 4yA~$$TQQabg 88OT * *t7T7T/T#%C  % %d 4::  0U **7$c^USURS5m[U4SjS55(a,U"5nURST;5 UR S5 ST;dST;a(U"5nUR 5 UR S5 S T;a)U"5nUR 5 UR S5 gg![a UmNf=f) 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,># UH oT;v M g7fN).0xinterpreted_argvs r$ /_preparse_for_stopping_flags..@s I*HQ *Hs)z-h --help-allz--helpr0rz --versionz-Vz--generate-config)index ValueErrorany print_helpexit print_versionwrite_default_config)rr r#r-s @r$_preparse_for_stopping_flagsr8-s  2$**T"23  I*H III! |'778  &&$2B*B!   ..!   "  /!   sC CCcn\rSrSrSr\"\"S5S9RSS9r\ RS5r Sr g ) ExtensionAppJinjaMixinRzAUse Jinja templates for HTML templates on top of an ExtensionApp.z;Options to pass to the jinja2 environment for this helpTconfigcUR5 [UR5S:a4URR UR S3UR05 [ S[UR5S/SS.URD6Ul URR UR S3UR05 g) 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_templates)ExtensionAppJinjaMixin._prepare_templates\s !!# t"" #a ' MM TYYK"?ATAT!U V& #D$7$78)* !!    ;7IJr&)rLN) __name__ __module__ __qualname____firstlineno____doc__r rtagrKt no_type_checkrO__static_attributes__r*r&r$r:r:RsGK     cc __KKr&r:c\rSrSrSrSrg)JupyterServerExtensionExceptionuz9Exception class for raising for Server extensions errors.r*N)rQrRrSrTrUrYr*r&r$r[r[usCr&r[c|^\rSrSr%SrSr0rS\S'\"SS9RSS9r \ "S 5S 5r \ S 5rSrS \S '\S5r\S5rSr\"5RSS9r\ "S5S5r\"S5r\"S5r\/r\"5rS\S'\ "S5S5r\r\ "S5S5r \ "S5S5r!\"SS9RSS9r"\ "S5S5r#\$"\"5SS9RSS9r%\$"\"5\&"S 5S9RSS9r'\("\&"S!5S9RSS9r)\$"\&"S"5S9RSS9r*S#\S$'S%r+S&r,S'r-S(r.S)r/S*r0S+r1S,r2S-r3S;S.jr4S/r5U4S0jr6S1r7S2r8S3r9\S45r:S5r;\S65r<\r=\S\S=S8j5r?\S>S9j5r@S:rAU=rB$)? ExtensionApp~aBase 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_browsercrURceURRSRSS5$)NrraT) serverappr?getrMs r$_default_open_browser"ExtensionApp._default_open_browsers4~~)))~~$$[155ndKKr&cLURceURR$)z4Look on the same path as our parent for config files)rcconfig_file_pathsrMs r$rhExtensionApp.config_file_pathss$~~)))~~///r&zstr | Unicode[str, str]rJcURRS5n[US5(aSRUSS5$US$)zGet an extension package..r)rRsplitrjoin)clspartss r$get_extension_package"ExtensionApp.get_extension_packagesE$$S) a ) )88E!AJ' 'Qxr&cUR$)zGet an extension point.)rR)ros r$get_extension_point ExtensionApp.get_extension_points~~r&/ default_urlcUR$r)) extension_urlrMs r$ _default_urlExtensionApp._default_urls!!!r& notebooksFzServerApp | Nonercc[R"5(a[R"5$[5$![a [5$f=fr))r initializedinstance ExceptionrMs r$_default_serverappExtensionApp._default_serverappsO  " "  ))++{  {  s; AA log_levelc"[R$r))loggingINFOrMs r$_default_log_levelExtensionApp._default_log_levels ||r& log_formatcg)z2override default log format to include date & timezV%(color)s[%(levelname)1.1s %(asctime)s.%(msecs).03d %(name)s]%(end_color)s %(message)sr*rMs r$_default_log_format ExtensionApp._default_log_formats  e r&z9Url where the static assets for the extension are served.static_url_prefixcSURS3nURce[URRU5$)Nzstatic/rv)rJrcrbase_url)rN static_urls r$_default_static_url_prefix'ExtensionApp._default_static_url_prefixs;tyyk+ ~~)))T^^44jAAr&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, ...]]handlersc|UR(dgSRURRSS55$)zThe default config file name.zjupyter_{}_config-_)rJformatreplacerMs r$_config_file_name_default&ExtensionApp._config_file_name_defaults.yy"))$))*;*;C*EFFr&cg)z1Override this method to add handling of settings.Nr*rMs r$initialize_settings ExtensionApp.initialize_settingsr&cg)z_config`. _configN)class_own_traitskeysrgetattrextension_configrHrJ)rNtraitsrWs r$_prepare_configExtensionApp._prepare_config$sd&&(--/ &V'LV74+;(;V'L M/3/D/D  7+,(MsA0cURceURRnURR"S0URD6 URRURS3UR URU05 UR 5 URR"S0URD6 g)zPrepare the settings.N _static_pathsr*)rcweb_apprHrIrJ static_pathsr)rNwebapps r$_prepare_settingsExtensionApp._prepare_settings,s~~)))'' /v/ 99+]+T->->99+     " //r&czURceURRnUR5 /nURHtn[ UR SUS5nUSn0n[ U[5(aURUS'URUS5 XEU4nURU5 Mv [UR5S:aE[ URS5nUUR SS UR04nURU5 URS U5 g![a Nf=f) zPrepare the handlers.NrrrrJrlz(.*)static_handler_classpathz.*$)rcrrrrrH issubclassrrJrI IndexErrorappendrrr add_handlers) rNr new_handlers handler_itemspatternhandlerkwargs new_handlerrs r$_prepare_handlersExtensionApp._prepare_handlersAs<~~)))''   " !]]M#FOOJ$?qAQRG#A&G(*F'#899!%v  mA./#V4K    ,!+& t  !A %&t'='=vFJ 67**+G    (E<0'  sD-- D:9D:c[UR5S:a4URRURS3UR05 UR 5 g)z=Add templates to web app settings if extension has templates.rrAN)rrGrHrIrJrFrMs r$rOExtensionApp._prepare_templateslsI t"" #a ' MM TYYK"?ATAT!U V !!#r&cSURURURS.0nUSRUR5 U$)zThe jupyter server config.r)rwrafile_url_prefix)rwrarrIr`)rN base_configs r$_jupyter_server_config#ExtensionApp._jupyter_server_configrsO #// $ 1 1#'#7#7  K ''(=(=>r&cXlUR5 URURR5 UR URR 5 URRUR5 SUlg)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)rcload_config_file update_configr?parse_command_line extra_args_linkedrNrcs r$_link_jupyter_server_extension+ExtensionApp._link_jupyter_server_extension~sh#  4>>001  9 9: $$T[[1 r&cUR(d Sn[U5eUR5 UR5 UR 5 UR 5 g)a Initialize 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)rcr[rrOrr)rNmsgs r$ initializeExtensionApp.initializesR~~#  2#6 6  !    r&ct>[TU]5 URceURR5 g)z_Start the underlying Jupyter server. Server should be started after extension is initialized. N)superstartrc)rN __class__s r$rExtensionApp.starts.  ~~))) r&cg)z6Return a list of activity happening in this extension.Nr*rMs r$current_activityExtensionApp.current_activitysr&c # g7f)z0Cleanup any resources managed by this extension.Nr*rMs r$stop_extensionExtensionApp.stop_extensioncURceURR5 URR5 g)z#Stop the underlying Jupyter server.N)rcstopclear_instancerMs r$rExtensionApp.stops2~~)))  %%'r&cURnURURnURnUR 5 U$![a U"5nUR U5 N6f=f)zyInitialize and configure this extension, then add the extension's settings and handlers to the server's web application. )extension_managerextension_pointsrJr#KeyErrorrr)rorcrpoint extensions r$_load_jupyter_server_extension+ExtensionApp._load_jupyter_server_extensionso &77 @%66sxx@E I   @I  4 4Y ? @s%A"A*)A*c # g7f)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_extension,ExtensionApp._start_jupyter_server_extensionrrcU"5nXlUR5 URUR5 UR UR 5 UR RS[S[URS504S[S[URS504S[S[URS504S[S[URS 504S [S[URS 504S [S[URS 504S[S[URS504S[S[URS504/5 UR5 g)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) rcrrr?rrrextendr rrr)rorcrs r$load_classic_server_extension*ExtensionApp.load_classic_server_extensionsE '""$ 0 01$$Y%9%9:!!4#M)*<*<>^_` ;#}%..0W ;#}%..0W ;#}%..0W 9#}%..0U =#}%..E  =#}%..E  -#M)*<*<>[\]}C E L r&c :URR"S0UD6$)zaInstantiate the ServerApp Override to customize the ServerApp before it loads any configuration r*)serverapp_classr)rors r$make_serverappExtensionApp.make_serverapp=s ""++5f55r&c xUR5S0nURnSUR;a.URURS5 X@RS'SnUR"SSU0UD6nUR RUR 5 UR U=(d /URUS9 U$)zCreates 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*)rqload_other_extensionsr`rIraliasesrrJ)ror rrrrrcs r$initialize_serverExtensionApp.initialize_serverEs #88:DA33 C$8$8 8  & &s';';rsq" 08$'HHH#.+D*""JKYKFDiD:r&