}tf6dZddlmZddlZddlmZddlmZddlm Z m Z m Z m Z m Z mZmZmZmZddlmZddlmZd d lmZd d lmZmZmZmZGd d e ZGddeZGddeZy)zThe extension manager.) annotationsN)starmap)multi) AnyBoolDict HasTraitsInstanceListUnicodedefaultobservevalidate)LoggingConfigurable)ExtensionConfigManager)ExtensionMetadataErrorExtensionModuleNotFound get_loader get_metadataceZdZdZedZeddZeZ e ddZ e dZ e d Ze d Ze d Ze d Ze d ZdZdZdZdZdZy)ExtensionPointzA simple API for connecting to a Jupyter Server extension point defined by metadata and importable from a Python package. FNT allow_nonemetadatac|d} |d|_ tj|j|_d|vr|d|_|S#t$rd}t|dwxYw#t $rd|jd}t|dwxYw)zValidate metadata.valuemodulez' could not be found. Are you sure the extension is installed?app) _module_nameKeyErrorr importlib import_module_module ImportErrorr_app)selfproposedrmsgs j/var/www/html/software/conda/envs/higlass/lib/python3.12/site-packages/jupyter_server/extension/manager.py_valid_metadatazExtensionPoint._valid_metadatasG$ 8 ( 2D   9$2243D3DEDL H ')DI 8PC(-4 7 8  9!$"3"3!4533 *#.D 8  9s A $A& A#&&B c^|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% 8888## #||c|jS)z'If the metadata includes an `app` field)r'r/s r+r zExtensionPoint.app>syyr1cR|jr|jjSiS)z:Return any configuration provided by this extension point.)r _jupyter_server_configr/s r+configzExtensionPoint.configCs% 8888224 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    r1c|jr|jjS|jjd|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.nameTs6 8888== }}  )9)9::r1c|jS)z3The imported module (using importlib.import_module))r%r/s r+rzExtensionPoint.module_s||r1c~|jr|jj}|St|jdd}|S)z Get a linker._link_jupyter_server_extensioncyN) serverapps r+z,ExtensionPoint._get_linker..nsr1)r r=getattrr)r(linkers r+ _get_linkerzExtensionPoint._get_linkerds? 88XX<33 *#.D 8  9s$A** B 3BB cVtd|jjDS)z.Validate all extension points in this package.c3<K|]}|jywr?r).0 extensions r+ z,ExtensionPackage.validate..sXI9%%'Xs)allrivaluesr/s r+rzExtensionPackage.validates"X9N9N9U9U9WXXXr1c|jj|d}|s!|j|}|j|yy)zLink an extension point.FN)_linked_pointsr:rirM)r( point_namerAr0rls r+ link_pointzExtensionPackage.link_points>$$((U;))*5E JJy !r1cB|j|}|j|S)zLoad an extension point.)rirO)r(rvrArls r+ load_pointzExtensionPackage.load_points!%%j1zz)$$r1cJ|jD]}|j||y)zLink all extension points.N)rirwr(rArvs r+link_all_pointsz ExtensionPackage.link_all_pointss%// 3J OOJ 2 3r1c`|jDcgc]}|j||c}Scc}w)zLoad all extension points.)riryr{s r+load_all_pointsz ExtensionPackage.load_all_pointss'IMI^I^_: I6___s+)rPrQrRrSr r9rr^rrurirrr rrZr r_rbrcrrwryr|r~ __classcell__)res@r+rWrWs C DD5JKGVNv D'c dFDF!XYHG Y77 " (Y"% 3 `r1rWceZdZdZeedZeZe ddZ e ddZ e dZed Ze d Zed Zed Zd ZdZdZddZdZdZdZdZdZdZdZy)ExtensionManagerzHigh level interface for findind, validating, linking, loading, and managing Jupyter Server extensions. Usage: m = ExtensionManager(config_manager=...) Trconfig_managerc<t}|j||Sr?)r_load_config_managerr(rs r+_load_default_config_managerz-ExtensionManager._load_default_config_managers/1 !!.1r1cT|jr|j|jyyr?)newr)r(changes r+_config_manager_changedz(ExtensionManager._config_manager_changeds ::  % %fjj 1 r1zq Dictionary with extension package names as keys and ExtensionPackage objects as values. rXcZtt|jjS)z8Returns an extensions dictionary, sorted alphabetically.)dictsorted extensionsitemsr/s r+sorted_extensionsz"ExtensionManager.sorted_extensions s!F4??002344r1z| Dictionary with extension names as keys values are True if the extension is linked, False if not. c |jjDcic]E\}}||jjDchc]}|js|jc}Gc}}}Scc}wcc}}}w)zCReturn mapping of extension names and sets of ExtensionApp objects.)rrrirsr )r(r9rprls r+extension_appszExtensionManager.extension_appssi $(??#8#8#:  i )*D*D*K*K*M[QVQZQZ599[ [  [ s%A3A.A.$A3.A3c|jjDcic]'}|jjD]\}}|| )c}}}Scc}}}w)zCReturn mapping of extension point names and ExtensionPoint objects.)rrsrir)r(rr9rls r+riz!ExtensionManager.extension_points&sb //1  $55;;= e %K    s,Ac||_y)z1Add extensions found by an ExtensionConfigManagerN)rrs r+from_config_managerz$ExtensionManager.from_config_manager/s -r1cF|j}|j|y)z Actually load our config managerN)get_jpserver_extensionsfrom_jpserver_extensions)r(rjpserver_extensionss r+rz%ExtensionManager._load_config_manager4s ,DDF %%&9:r1cZ|jD]\}}|j||y)z:Add extensions from 'jpserver_extensions'-like dictionary.)r^N)r add_extension)r(rr9r^s r+rz)ExtensionManager.from_jpserver_extensions9s10668 6MD'   tW  5 6r1c t||}||j|<y#t$rM}|jr|jjr|j j d|||dYd}~yd}~wwxYw)zeTry to add extension to manager, return True if successful. Otherwise, return False. )r9r^Tz-%s | error adding extension (enabled: %s): %sexc_infoNF)rWrrKrA!reraise_server_extension_failuresrhwarning)r(extension_namer^extpkgrjs r+rzExtensionManager.add_extension>sz %>7KF.4DOON + ~~$.."R"R HH  ?    s A5AA00A5c|jj|d}|j|}|sU|jrH |j |j d|j|<|j jd|yyy#t$rL}|j r|j jr|j jd||dYd}~yd}~wwxYw)zLink an extension by name.FTz'%s | extension was successfully linked.z %s | error linking extension: %srN) linked_extensionsr:rr^r|rArhinforKrr)r(r9r0rprjs r+link_extensionzExtensionManager.link_extensionSs''++D%8OOD) )++ ]))$..9/3&&t, GN ,v  ]>>dnn&V&V  !CT1W[ \\ ]sAB C ACCcz|jj|}|rF|jr9 |j|j|j j d|yyy#t$rL}|jr|jjr|j jd||dYd}~yd}~wwxYw)zLoad an extension by name.z'%s | extension was successfully loaded.z.%s | extension failed loading with message: %rTrN) rr:r^r~rArhrrKrr)r(r9rprjs r+load_extensionzExtensionManager.load_extensionbsOO''- ** O))$..9 GN+9 >>dnn&V&V  DdAX\! sA%% B:.AB55B:cK|D]h}|jjd||j|jd{|jjd||jjy7.w)z.Call the shutdown hooks in the specified apps.z%s | extension app %r stoppingNz%s | extension app %r stopped)rhdebugr9stop_extension)r(r9appsr s r+rzExtensionManager.stop_extensionrs^ LC HHNN;T388 L$$& & & HHNN:D#(( K L &sAA3A1/A3cH|jD]}|j|y)zHLink all enabled extensions to an instance of ServerApp N)rrr(r9s r+link_all_extensionsz$ExtensionManager.link_all_extensionsy' ** &D    % &r1cH|jD]}|j|y)zULoad all enabled extensions and append them to the parent ServerApp. N)rrrs r+load_all_extensionsz$ExtensionManager.load_all_extensionsrr1c Kttt|jt t |j jd{y7w)z*Call the shutdown hooks in all extensions.N)rlistrrrrrrr/s r+stop_all_extensionsz$ExtensionManager.stop_all_extensionss?D!4!4fT$BUBU=V=\=\=^6_`abbbsAA AA ctt|jjD]\}}|D]}|j sy!y)zMCheck for any activity currently happening across all extension applications.TN)rrrrcurrent_activity)r(_rr s r+ any_activityzExtensionManager.any_activitysLd4#6#67==?@ GAt '')  r1N)F)rPrQrRrSr rrrrAr rrrrrrUrrrrirrrrrrrrrrrr@r1r+rrs4FNI   22 J55     - ; 6 * ]O L&&c r1r) rS __future__rr# itertoolsr tornado.genr traitletsrrrr r r r r rrrTtraitlets.configrr5rutilsrrrrrrWrr@r1r+rs\"[[[00*\\F!YF!RN`*N`bi *i r1