Mh?dZddlmZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZddlmZddlmZd d lmZd d lmZmZmZmZGd d e ZGddeZGddeZdS)zThe extension manager.) annotationsN)starmap)multi) AnyBoolDict HasTraitsInstanceListUnicodedefaultobservevalidate)LoggingConfigurable)ExtensionConfigManager)ExtensionMetadataErrorExtensionModuleNotFound get_loader get_metadatac,eZdZdZedZeddZeZ e ddZ e dZ e d Ze d Ze d Ze d Ze d ZdZdZdZdZdZdZdZdS)ExtensionPointzA simple API for connecting to a Jupyter Server extension point defined by metadata and importable from a Python package. FNT allow_nonemetadatac8|d} |d|_n #t$rd}t|dwxYw tj|j|_n)#t $rd|jd}t|dwxYwd|vr|d|_|S)zValidate metadata.valuemodulez' could not be found. Are you sure the extension is installed?app) _module_nameKeyErrorr importlib import_module_module ImportErrorr_app)selfproposedrmsgs `/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/jupyter_server/extension/manager.py_valid_metadatazExtensionPoint._valid_metadatasG$ 8 ( 2D   8 8 8PC(--4 7 8 9$243DEEDLL 9 9 93$"3333 *#..D 8  9 H  '))DIs 5A&A>c6|jr |jjS|jS)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+linkedzExtensionPoint.linked3s! 8 $8# #|c|jS)z'If the metadata includes an `app` field)r'r/s r+r zExtensionPoint.app>s yr1cF|jr|jSiS)z:Return any configuration provided by this extension point.)r _jupyter_server_configr/s r+configzExtensionPoint.configCs) 8 82244 4Ir1c|jS)zuName of the Python package module where the extension's _load_jupyter_server_extension can be found. )r!r/s r+ module_namezExtensionPoint.module_nameMs   r1ch|jr |jjS|jd|jS)zName of the extension. If it's not provided in the metadata, `name` is set to the extensions' module name. name)r r9rgetr7r/s r+r9zExtensionPoint.nameTs3 8 !8= }  )9:::r1c|jS)z3The imported module (using importlib.import_module))r%r/s r+rzExtensionPoint.module_s |r1c\|jr |jj}nt|jdd}|S)z Get a linker._link_jupyter_server_extensioncdSN serverapps r+z,ExtensionPoint._get_linker..ns$r1)r r=getattrr)r(linkers r+ _get_linkerzExtensionPoint._get_linkerds< 8 X._noop_starts r1_start_jupyter_server_extension)r rNrDr)r(rErMs r+ _get_starterzExtensionPoint._get_starterzsJ 8 X=FF    1 F r1cz ||dS#t$rYdSwxYw)z+Check that both a linker and loader exists.TF)rFrJ Exceptionr/s r+rzExtensionPoint.validatesV             4   55 s (, ::cd|js(|}||d|_dSdS)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)r0rFr.)r(rBrEs r+linkzExtensionPoint.linksD { %%''F F9   DLLL   r1c@|}||S)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. )rJ)r(rBrIs r+loadzExtensionPoint.loads% !!##vi   r1cPK|}||d{VS)zCall's the extensions 'start' hook where it can start (possibly async) tasks _after_ the event loop is running. N)rO)r(rBstarters r+startzExtensionPoint.starts;##%%WY'''''''''r1)__name__ __module__ __qualname____doc__rr.rr'rrvalidate_traitr,propertyr0r r5r7r9rrFrJrOrrSrUrXr@r1r+rrs{d5kkG 3t % % %DtvvH^J .XXX!!X! ;;X;X   $    !!!(((((r1rc0eZdZdZedZeddZeZ eZ e ddZ e ed Zed Zed d Zfd ZdZdZdZdZdZdZdZdZxZS)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)rrbz5Extension metadata loaded from the extension package.z| The version of this extension package, if it can be found. Otherwise, an empty string. versionc@|jsdSt|jddS)N __version__)enabledrDrr/s r+ _load_versionzExtensionPackage._load_versions%| 2t{M2666r1c ttjdi||jr|dSdS)z Initialize an extension package.Nr@)super__init__rg_load_metadata)r(kwargs __class__s r+rkzExtensionPackage.__init__sL""6""" < "    ! ! ! ! ! " "r1c|j} t||j\|_|_n+#t $r}d|d|d}t |dd}~wwxYw|jD]!}t|}||j|j<"|S)z\Import 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) r9rlogrrr&rrextension_points)r(r9er*mpoints r+rlzExtensionPackage._load_metadatas y 9)5d48)L)L)L &DK 9 9 93t331333 *#..D 8  9 6 6A"A...E05D !%* - - s#- AAAcbtd|jDS)z.Validate all extension points in this package.c3>K|]}|VdSr?r).0 extensions r+ z,ExtensionPackage.validate..s.XXI9%%''XXXXXXr1)allrrvaluesr/s r+rzExtensionPackage.validates.XX9N9U9U9W9WXXXXXXr1c|j|d}|s$|j|}||dSdS)zLink an extension point.FN)_linked_pointsr:rrrS)r( point_namerBr0rus r+ link_pointzExtensionPackage.link_pointsQ$((U;; ")*5E JJy ! ! ! ! ! " "r1cF|j|}||S)Load an extension point.)rrrUr(rrBrus r+ load_pointzExtensionPackage.load_points!%j1zz)$$$r1cVK|j|}||d{VS)rN)rrrXrs r+ start_pointzExtensionPackage.start_points7%j1[[+++++++++r1cF|jD]}|||dS)zLink all extension points.N)rrrr(rBrs r+link_all_pointsz ExtensionPackage.link_all_pointss5/ 3 3J OOJ 2 2 2 2 3 3r1c.fdjDS)Load all extension points.c<g|]}|Sr@)r)rxrr(rBs r+ z4ExtensionPackage.load_all_points..s'___: I66___r1)rr)r(rBs``r+load_all_pointsz ExtensionPackage.load_all_pointss$_____I^____r1cVK|jD]}|||d{VdS)rN)rrrrs r+start_all_pointsz!ExtensionPackage.start_all_pointssM/ : :J"":y99 9 9 9 9 9 9 9 9 : :r1)rYrZr[r\r r9rrgrr~rrrrr rrcr rhrkrlrrrrrrr __classcell__)rns@r+r`r`sr 7C D D DDd5JKKKGTVVNtvv SD'c d d dFtDDFF!XYYYHgG WY777 """"" (YYY"""%%% ,,, 333 ```:::::::r1r`cReZdZdZeedZeZe ddZ e ddZ e dZed Ze d Zed Zed Zd ZdZdZddZdZdZdZdZdZdZdZdZdZ dS)ExtensionManagerzHigh level interface for finding, validating, linking, loading, and managing Jupyter Server extensions. Usage: m = ExtensionManager(config_manager=...) Trconfig_managercLt}|||Sr?)r_load_config_managerr(rs r+_load_default_config_managerz-ExtensionManager._load_default_config_managers'/11 !!.111r1cL|jr||jdSdSr?)newr)r(changes r+_config_manager_changedz(ExtensionManager._config_manager_changed s2 : 2  % %fj 1 1 1 1 1 2 2r1zq Dictionary with extension package names as keys and ExtensionPackage objects as values. rachtt|jS)z8Returns an extensions dictionary, sorted alphabetically.)dictsorted extensionsitemsr/s r+sorted_extensionsz"ExtensionManager.sorted_extensions0s(F4?002233444r1z| Dictionary with extension names as keys values are True if the extension is linked, False if not. cHd|jDS)zCReturn mapping of extension names and sets of ExtensionApp objects.c\i|])\}}|d|jD*S)c*h|]}|j |jSr@)r )rxrus r+ z=ExtensionManager.extension_apps...Es#[[[QVQZ[59[[[r1)rrr|)rxr9rys r+ z3ExtensionManager.extension_apps..DsL   i [[)*D*K*K*M*M[[[   r1)rrr/s r+extension_appszExtensionManager.extension_appsAs1  #'?#8#8#:#:    r1cHd|jDS)zCReturn mapping of extension point names and ExtensionPoint objects.cRi|]$}|jD]\}}|| %Sr@)rrr)rxrr9rus r+rz5ExtensionManager.extension_points..LsT   $5;;==  e %    r1)rr|r/s r+rrz!ExtensionManager.extension_pointsIs1  //11    r1c||_dS)z1Add extensions found by an ExtensionConfigManagerN)rrs r+from_config_managerz$ExtensionManager.from_config_managerRs-r1cX|}||dS)z Actually load our config managerN)get_jpserver_extensionsfrom_jpserver_extensions)r(rjpserver_extensionss r+rz%ExtensionManager._load_config_managerWs/,DDFF %%&9:::::r1ch|D]\}}|||dS)z:Add extensions from 'jpserver_extensions'-like dictionary.)rgN)r add_extension)r(rr9rgs r+rz)ExtensionManager.from_jpserver_extensions\sG06688 6 6MD'   tW  5 5 5 5 6 6r1Fc t||}||j|<dS#t$r=}|jr |jjr|jd|||dYd}~nd}~wwxYwdS)zeTry to add extension to manager, return True if successful. Otherwise, return False. )r9rgTz-%s | error adding extension (enabled: %s): %sexc_infoNF)r`rrQrB!reraise_server_extension_failuresrqwarning)r(extension_namergextpkgrss r+rzExtensionManager.add_extensionas %>7KKKF.4DON +4   ~ $."R  H  ?          us A&3A!!A&c|j|d}|j|}|s|jr ||jd|j|<|jd|dS#t$r=}|jr |jj r|j d||dYd}~dSd}~wwxYwdSdS)zLink an extension by name.FTz'%s | extension was successfully linked.z %s | error linking extension: %srN) linked_extensionsr:rrgrrBrqinforQrr)r(r9r0ryrss r+link_extensionzExtensionManager.link_extensionvs'++D%88OD)  ])+ ] ]))$.999/3&t, GNNNNN ] ] ]>dn&V  !CT1W[ \\\\\\\\\ ] ] ] ] ]s?A44 B;>2B66B;cT|j|}|r|jr ||j|jd|dS#t$r=}|jr |jjr|j d||dYd}~dSd}~wwxYwdSdS)zLoad an extension by name.z'%s | extension was successfully loaded.z.%s | extension failed loading with message: %rTrN) rr:rgrrBrqrrQrrr(r9ryrss r+load_extensionzExtensionManager.load_extensionsO''--  O* O O))$.999 GNNNNN   >dn&V  DdAX\!  O O O OsA B#&2BB#cdK|j|}|r|jr ||jd{V|jd|dS#t$r=}|jr |jjr|j d||dYd}~dSd}~wwxYwdSdS)zStart an extension by name.Nz(%s | extension was successfully started.z/%s | extension failed starting with message: %rTr) rr:rgrrBrqdebugrQrrrs r+start_extensionz ExtensionManager.start_extensionsO''--  Q* Q Q00@@@@@@@@@I4PPPPP   >dn&V  EtQY]!  Q Q Q Qs A$$ B+.2B&&B+cK|D]^}|jd||j|d{V|jd||j_dS)z.Call the shutdown hooks in the specified apps.z%s | extension app %r stoppingNz%s | extension app %r stopped)rqrr9stop_extension)r(r9appsr s r+rzExtensionManager.stop_extensions L LC HNN;T38 L L L$$&& & & & & & & & HNN:D#( K K K K L Lr1cD|jD]}||dS)zHLink all enabled extensions to an instance of ServerApp N)rrr(r9s r+link_all_extensionsz$ExtensionManager.link_all_extensions7 * & &D    % % % % & &r1cD|jD]}||dS)zULoad all enabled extensions and append them to the parent ServerApp. N)rrrs r+load_all_extensionsz$ExtensionManager.load_all_extensionsrr1cXKtfdjDd{VdS)zStart all enabled extensions.c:g|]}|Sr@)r)rxr9r(s r+rz9ExtensionManager.start_all_extensions..s'SSSDT))$//SSSr1N)rrr/s`r+start_all_extensionsz%ExtensionManager.start_all_extensionssGSSSSDrs""""""[[[[[[[[[[[[[[[[[[[[[[000000000000******\\\\\\\\\\\\_(_(_(_(_(Y_(_(_(DX:X:X:X:X:*X:X:X:v     *     r1