^h?SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r J r J r J r JrJrJrJrJr SSK Jr SSKJr S S KJr S S KJrJrJrJr "S S \ 5r"SS\5r"SS\5r g)zThe extension manager.) annotationsN)starmap)multi) AnyBoolDict HasTraitsInstanceListUnicodedefaultobservevalidate)LoggingConfigurable)ExtensionConfigManager)ExtensionMetadataErrorExtensionModuleNotFound get_loader get_metadatac*\rSrSrSr\"S5r\"SSS9r\ "5r \ "\ R5r\"S5S5r\"S 5S 5r\S 5r\S 5r\S 5r\S5r\S5r\S5rSrSrSrSrSrSrSr Sr!g)ExtensionPointzzA simple API for connecting to a Jupyter Server extension point defined by metadata and importable from a Python package. FNT allow_nonelogc.[R"S5$)Nr)logging getLoggerselfs Z/home/james-whalen/.local/lib/python3.13/site-packages/jupyter_server/extension/manager.py _default_logExtensionPoint._default_logs  !122metadatac(USnUSUl[R"UR5UlSU;aUS"5UlU$![a Sn[U5Sef=f![ a SURS3n[U5Sef=f)zValidate metadata.valuemodulez' could not be found. Are you sure the extension is installed?app) _module_nameKeyErrorr importlib import_module_module ImportErrorr_app)r"proposedr'msgs r#_valid_metadataExtensionPoint._valid_metadata"sG$ 8 ( 2D   9$2243D3DEDL H  )DI 8PC(-4 7 8  9!$"3"3!4533 *#.D 8  9s A%A*A'*'BchUR(aURR$UR$)zHas this extension point been linked to the server. Will pull from ExtensionApp's trait, if this point is an instance of ExtensionApp. )r+_linkedr!s r#linkedExtensionPoint.linked:s% 8888## #||r&cUR$)z'If the metadata includes an `app` field)r2r!s r#r+ExtensionPoint.appEsyyr&c\UR(aURR5$0$)z:Return any configuration provided by this extension point.)r+_jupyter_server_configr!s r#configExtensionPoint.configJs% 8888224 4Ir&cUR$)zeName of the Python package module where the extension's _load_jupyter_server_extension can be found. )r,r!s r# module_nameExtensionPoint.module_nameTs    r&cUR(aURR$URRSUR5$)zlName of the extension. If it's not provided in the metadata, `name` is set to the extensions' module name. name)r+rEr'getrBr!s r#rEExtensionPoint.name[s6 8888== }}  )9)9::r&cUR$)z3The imported module (using importlib.import_module))r0r!s r#r*ExtensionPoint.modulefs||r&cUR(aURRnU$[URSS5nU$)z Get a linker._link_jupyter_server_extensioncgN serverapps r#,ExtensionPoint._get_linker..us$r&)r+rKgetattrr*)r"linkers r# _get_linkerExtensionPoint._get_linkerks? 88XX<._noop_startss_start_jupyter_server_extension)r+r`rSr*)r"rTr^s r# _get_starterExtensionPoint._get_startersD 88XX==F   1 F r&cfUR5 UR5 g![a gf=f)z+Check that both a linker and loader exists.TF)rUrZ Exceptionr!s r#rExtensionPoint.validates8           s # 00cfUR(d UR5nU"U5 SUlgg)zLink the extension to a Jupyter ServerApp object. This looks for a `_link_jupyter_server_extension` function in the extension's module or ExtensionApp class. TN)r9rUr8)r"rPrTs r#linkExtensionPoint.links- {{%%'F 9 DL r&c2UR5nU"U5$)zLoad the extension in a Jupyter ServerApp object. This looks for a `_load_jupyter_server_extension` function in the extension's module or ExtensionApp class. )rZ)r"rPrYs r#loadExtensionPoint.loads !!#i  r&cN# UR5nU"U5IShvN $N7f)zpCall's the extensions 'start' hook where it can start (possibly async) tasks _after_ the event loop is running. N)ra)r"rPstarters r#startExtensionPoint.starts&##%Y''''s %#%)r2r8r0r,)"__name__ __module__ __qualname____firstlineno____doc__rr8rr2rr'r rLoggerrr r$validate_traitr5propertyr9r+r?rBrEr*rUrZrarrgrjrn__static_attributes__rNr&r#rrs5kG t %DvH 7>> "C U^33J .!! ;; $  !(r&rc^\rSrSrSr\"SS9r\"SSS9r\ "5r \ "5r \ "SSS 9r \"\ "5S S9r\"S S9r\"S 5S 5rU4SjrSrSrSrSrSrSrSrSrSrU=r$)ExtensionPackagezAn API for interfacing with a Jupyter Server extension package. Usage: ext_name = "my_extensions" extpkg = ExtensionPackage(name=ext_name) z)Name of the an importable Python package.helpFz)Whether the extension package is enabled.Tz:The module for this extension package. None if not enabled)rr}z5Extension metadata loaded from the extension package.z| The version of this extension package, if it can be found. Otherwise, an empty string. versioncTUR(dg[URSS5$)N __version__)enabledrSr*r!s r# _load_versionExtensionPackage._load_versions||t{{M266r&c j>[TU]"S0UD6 UR(aUR5 gg)z Initialize an extension package.NrN)super__init__r_load_metadata)r"kwargs __class__s r#rExtensionPackage.__init__s+ "6" <<    ! r&c*URn[XRS9uUlUlURH.n[X@RS9nXPRUR'M0 U$![ anSUSUS3n[ U5SeSnAff=f)zLImport package and load metadata Only used if extension package is enabled )loggerz The module 'z' could not be found (z+). Are you sure the extension is installed?N)r'r) rErrr*r'r1rrextension_points)r"rEer4mpoints r#rExtensionPackage._load_metadatas yy 9)5d88)L &DKA"A8833 *#.D 8  9s A.. B8B  BcV[SURR555$)z.Validate all extension points in this package.c3@# UHoR5v M g7frMr).0 extensions r# ,ExtensionPackage.validate..sX9WI%%''9Ws)allrvaluesr!s r#rExtensionPackage.validates"X9N9N9U9U9WXXXr&cURRUS5nU(d!URUnURU5 gg)zLink an extension point.FN)_linked_pointsrFrrg)r" point_namerPr9rs r# link_pointExtensionPackage.link_points>$$((U;))*5E JJy !r&cBURUnURU5$)Load an extension point.)rrjr"rrPrs r# load_pointExtensionPackage.load_points!%%j1zz)$$r&c^# URUnURU5IShvN $N7f)rN)rrnrs r# start_pointExtensionPackage.start_points*%%j1[[++++s $-+-cLURHnURX!5 M g)zLink all extension points.N)rrr"rPrs r#link_all_points ExtensionPackage.link_all_pointss//J OOJ 20r&cbURVs/sHo RX!5PM sn$s snf)Load all extension points.)rrrs r#load_all_points ExtensionPackage.load_all_points s)IMI^I^_I^: 6I^___s,ch# URHnURX!5IShvN M gN 7f)rN)rrrs r#start_all_points!ExtensionPackage.start_all_pointss,//J"":9 9 90 9s $20 2)r'r*)rprqrrrsrtr rErrrrrrr*r r'r~r rrrrrrrrrrrx __classcell__)rs@r#rzrzs C DD5JKGVNv D'c dFDF!XYHG Y77 " (Y"% , 3 `::r&rzc\rSrSrSr\"\SS9r\"5r \ "S5S5r \ "S5S5r \"SS 9r\S 5r\"S S 9r\S 5r\S 5rSrSrSrSSjrSrSrSrSrSrSrSrSr Sr!Sr"g)ExtensionManagerizHigh level interface for finding, validating, linking, loading, and managing Jupyter Server extensions. Usage: m = ExtensionManager(config_manager=...) Trconfig_managerc<[5nURU5 U$rM)r_load_config_managerr"rs r#_load_default_config_manager-ExtensionManager._load_default_config_manager!s/1 !!.1r&c^UR(aURUR5 ggrM)newr)r"changes r#_config_manager_changed(ExtensionManager._config_manager_changed's ::  % %fjj 1 r&zq Dictionary with extension package names as keys and ExtensionPackage objects as values. r|cZ[[URR555$)z8Returns an extensions dictionary, sorted alphabetically.)dictsorted extensionsitemsr!s r#sorted_extensions"ExtensionManager.sorted_extensions7s!F4??002344r&z| Dictionary with extension names as keys values are True if the extension is linked, False if not. c URR5VVVs0sHLupXRR5Vs1sH!o3R(dMURiM# sn_MN snnn$s snfs snnnf)zCReturn mapping of extension names and sets of ExtensionApp objects.)rrrrr+)r"rErrs r#extension_appsExtensionManager.extension_appsHsj $(??#8#8#: #: *D*D*K*K*M[*MQZQZ9599*M[ [#:  [ s$A<A7A7+A<7A<cURR5VVVs0sH)nURR5Hup#X#_M M+ snnn$s snnnf)zCReturn mapping of extension point names and ExtensionPoint objects.)rrrr)r"r)rErs r#r!ExtensionManager.extension_pointsPsV //1 1$55;;=  K= 1   s0AcXlg)z1Add extensions found by an ExtensionConfigManagerNrrs r#from_config_manager$ExtensionManager.from_config_managerYs -r&cFUR5nURU5 g)z Actually load our config managerN)get_jpserver_extensionsfrom_jpserver_extensions)r"rjpserver_extensionss r#r%ExtensionManager._load_config_manager^s ,DDF %%&9:r&cTUR5Hup#URX#S9 M g)z:Add extensions from 'jpserver_extensions'-like dictionary.)rN)r add_extension)r"rrErs r#r)ExtensionManager.from_jpserver_extensionscs(0668MD   t  59r&c [XS9nX0RU'g![aTnUR(aURR(aeUR R SUUUSS9 SnAgSnAff=f)zUTry to add extension to manager, return True if successful. Otherwise, return False. )rErTz-%s | error adding extension (enabled: %s): %sexc_infoNF)rzrrdrP!reraise_server_extension_failuresrwarning)r"extension_namerextpkgrs r#rExtensionManager.add_extensionhsq %>KF.4OON + ~~$.."R"R HH  ?   s A8A A33A8cURRUS5nURUnU(dZUR(aHUR UR 5 SURU'UR RSU5 ggg![aRnUR (aUR R(aeUR RSXSS9 SnAgSnAff=f)zLink an extension by name.FTz'%s | extension was successfully linked.z %s | error linking extension: %srN) linked_extensionsrFrrrrPrinfordrr)r"rEr9rrs r#link_extensionExtensionManager.link_extension}s''++D%8OOD) )++ ]))$..9/3&&t, GN ,v  ]>>dnn&V&V  !CTW[ \ ]sAB C*AC%%C*cURRU5nU(aKUR(a9URUR5 UR R SU5 ggg![aRnUR(aURR(aeUR RSXSS9 SnAgSnAff=f)zLoad an extension by name.z'%s | extension was successfully loaded.z.%s | extension failed loading with message: %rTrN) rrFrrrPrrrdrrr"rErrs r#load_extensionExtensionManager.load_extensionsOO''- ** O))$..9 GN+9 >>dnn&V&V  DdX\! sA// C 9ACC c# URRU5nU(aSUR(aAURUR5IShvN UR R SU5 gggN#![aRnUR(aURR(aeUR RSXSS9 SnAgSnAff=f7f)zStart an extension by name.Nz(%s | extension was successfully started.z/%s | extension failed starting with message: %rTr) rrFrrrPrdebugrdrrrs r#start_extension ExtensionManager.start_extensionsOO''- ** Q00@@@I4P+9@ >>dnn&V&V  EtY]! sA4CA;A9A;C9A;; CAC CCCc# UHgnURRSXR5 UR5IShvN URRSXR5 Mi gN/7f)z.Call the shutdown hooks in the specified apps.z%s | extension app %r stoppingNz%s | extension app %r stopped)rrrEstop_extension)r"rEappsr+s r#rExtensionManager.stop_extensionsRC HHNN;T88 L$$& & & HHNN:D(( K &s?A3A10A3cLURHnURU5 M g)z8Link all enabled extensions to an instance of ServerApp N)rrr"rEs r#link_all_extensions$ExtensionManager.link_all_extensions" **D    %+r&cLURHnURU5 M g)zELoad all enabled extensions and append them to the parent ServerApp. N)rrrs r#load_all_extensions$ExtensionManager.load_all_extensionsrr&c# [URVs/sHoRU5PM sn5IShvN gs snfN 7f)zStart all enabled extensions.N)rrrrs r#start_all_extensions%ExtensionManager.start_all_extensionss;DD!4!4fT$BUBU=V=\=\=^6_`abbbsAA AA c[[UR5R55H&upUHnUR 5(dM g M( g)zMCheck for any activity currently happening across all extension applications.TN)rrrrcurrent_activity)r"_rr+s r# any_activityExtensionManager.any_activitysDd4#6#67==?@GA''))Ar&rN)F)#rprqrrrsrtr rrrrPr rrrrrrwrrrrrrrrrrrrrrrrrrxrNr&r#rrs4FNI   22 J55     - ; 6 * ]O Q L&&U c r&r)!rt __future__rr.r itertoolsr tornado.genr traitletsrrrr r r r r rrrvtraitlets.configrr?rutilsrrrrrrzrrNr&r#r s]"[[[00*\\e(Ye(PX:*X:v * r&