Xh hDdZddlZddlZddlmZmZmZmZddlm Z ddl m Z m Z ddl Z ddlmZddlmZddlmZmZdd lmZmZmZmZmZd d d d ZdZej:dej:dej:ddZdZedGddZ edGddZ!edGddZ"edGdde"Z#edGddZ$eGd d!Z%Gd"d#eZ&Gd$d%e&Z'y)&z'Base classes for the extension manager.N) dataclassfieldfieldsreplace)Path)OptionalUnion) translator)Enum) ConfigurableLoggingConfigurable) _AppHandler_ensure_optionsdisable_extensionenable_extension get_app_infoz-alpha.z-beta.z-rc.)abrcc@t|}|j|d<y)z0Ensure that the app info has compat_errors field compat_errorsN)r_get_extension_compat)info app_optionshandlers Q/var/www/html/myenv/lib/python3.12/site-packages/jupyterlab/extensions/manager.py_ensure_compat_errorsrs+&G#99;Dz*(?P.*) needs to be included in buildz+(?P.*) needs to be removed from buildz:(?P.*) changed from (?P.*) to (?P.*)install uninstallupdatect|}|jd}gggd}|D]U}tjD]<\}}|j |}|s||j |j d>W|S)z8Get info about packages scheduled for (un)install/updateT)fastrname)r build_check _message_mapitemsmatchappendgroup)rrmessagesstatusmsgkeypatternr)s r_build_check_infor1)s+&G"""-H" ;F8(..0 8LCMM#&Es ""5;;v#67 88 MrT)frozencPeZdZUdZeed<eed<eed<eed<dZeed<dZeed <d Z e eed <dZ eed <dZ eed <d Z e eed<d Ze eed<dZeed<dZeed<dZeed<d Ze eed<d Ze eed<d Ze eed<d Ze eed<d Ze eed<d Ze eed<y )ExtensionPackageaExtension package entry. Attributes: name: Package name description: Package description homepage_url: Package home page pkg_type: Type of package - ["prebuilt", "source"] allowed: [optional] Whether this extension is allowed or not - default True approved: [optional] Whether the package is approved by your administrators - default False companion: [optional] Type of companion for the frontend extension - [None, "kernel", "server"]; default None core: [optional] Whether the package is a core package or not - default False enabled: [optional] Whether the package is enabled or not - default False install: [optional] Extension package installation instructions - default None installed: [optional] Whether the extension is currently installed - default None installed_version: [optional] Installed version - default "" latest_version: [optional] Latest available version - default "" status: [optional] Package status - ["ok", "warning", "error"]; default "ok" author: [optional] Package author - default None license: [optional] Package license - default None bug_tracker_url: [optional] Package bug tracker URL - default None documentation_url: [optional] Package documentation URL - default None package_manager_url: Package home page in the package manager - default None repository_url: [optional] Package code repository URL - default None r% description homepage_urlpkg_typeTallowedFapprovedN companioncoreenabledr installedinstalled_versionlatest_versionokr-authorlicensebug_tracker_urldocumentation_urlpackage_manager_urlrepository_url)__name__ __module__ __qualname____doc__str__annotations__r8boolr9r:rr;r<r dictr=r?r@r-rBrCrDrErFrGrrr4r47s2 IMGTHd#Ix}#D$GT"GXd^" $Ix~$sNCFC FHSM !GXc]!%)OXc])'+x}+)-#-$(NHSM(rr4cReZdZUdZeed<dZeeed<ee Z e eed<y) ActionResultzAction result Attributes: status: Action status - ["ok", "warning", "error"] message: Action status explanation needs_restart: Required action follow-up - Valid follow-up are "frontend", "kernel" and "server" r-Nmessagedefault_factory needs_restart) rHrIrJrKrLrMrSrrlistrVrPrrrRrRhs/ K!GXc]!$T:M49:rrRcBeZdZUdZeeZeeed<dZ e ed<y)PluginManagerOptionsalPlugin manager options. Attributes: lock_all: Whether to lock (prevent enabling/disabling) all plugins. lock_rules: A list of plugins or extensions that cannot be toggled. If extension name is provided, all its plugins will be disabled. The plugin names need to follow colon-separated format of `extension:plugin`. rT lock_rulesFlock_allN) rHrIrJrKr frozensetrZrLrMr[rNrPrrrYrYys&"'y!AJ #AHdrrYceZdZUdZeeZeeed<eeZ eeed<dZ e ed<ee Z e ed<y) ExtensionManagerOptionsa Extension manager options. Attributes: allowed_extensions_uris: A list of comma-separated URIs to get the allowed extensions list blocked_extensions_uris: A list of comma-separated URIs to get the blocked extensions list listings_refresh_seconds: The interval delay in seconds to refresh the lists listings_tornado_options: The optional kwargs to use for the listings HTTP requests as described on https://www.tornadoweb.org/en/stable/httpclient.html#tornado.httpclient.HTTPRequest rTallowed_extensions_urisblocked_extensions_urisilistings_refresh_secondslistings_tornado_optionsN)rHrIrJrKrsetr_rLrMr`raintrOrbrPrrr^r^sL).c(BSXB(-c(BSXB$+c+%*4%@d@rr^c>eZdZUdZeed<dZeed<dZe eed<y)ExtensionManagerMetadataa#Extension manager metadata. Attributes: name: Extension manager name to be displayed can_install: Whether the extension manager can un-/install packages (default False) install_path: Installation path for the extensions (default None); e.g. environment path r%F can_installN install_path) rHrIrJrKrLrMrgrNrhrrPrrrfrfs& IK"&L(3-&rrfcVeZdZUdZeeZeeeee e ffe d<dZ ee d<y)ExtensionsCachez{Extensions cache Attributes: cache: Extension list per page last_page: Last available page result rTcache last_pageN) rHrIrJrKrrOrkrdrrLr4rMrmrPrrrjrjs>?DTX>YE4Xd3(8#89:: ;YIsrrjc eZdZdZegdddj dZ dd eed eed ee d dffd Z d efdZ de e d ee fdZdee e e fd efdZdee e e fd efdZxZS) PluginManageraPlugin manager enables or disables plugins unless locked. It can also disable/enable all plugins in an extension. Args: app_options: Application options ext_options: Plugin manager (subset of extension manager) options parent: Configurable parent Attributes: app_options: Application options options: Plugin manager options ) sys_prefixusersystemrpz:Level at which to manage plugins: sys_prefix, user, system)values default_valuehelpT)configNr ext_optionsparentreturnct |||jjd|jj d|j dt||_ttDchc]}|j}}|xsijDcic] \}}||vr||}}}tdi||_ ycc}wcc}}w)N)rxz Plugins in z will managed on the z levelrP)super__init__logdebug __class__rHlevelrrrrYr%r(options) selfrrwrxfplugin_options_fieldoptionvalueplugin_optionsrs rr|zPluginManager.__init__s ' $..1122G |SY Z +;7067K0LM1MM#."3!:!:!< -- EM  ,=n= N s 3CC cvKt|jj|jjdSw)z8Get information about locks on plugin enabling/disabling) lockRules allLocked)rWrrZr[rs r plugin_lockszPluginManager.plugin_lockss1dll556..  s79plugins_or_extensionsch|jjr t|St}|jjDchc]}|j dd}}|D]G}d|vr+||jjvs |j |2||vs7|j |I|Scc}w)z9Find a subset of plugins (or extensions) which are locked:r)rr[rcrZsplitadd)rr locked_subsetpluginextensions_with_locked_pluginss r _find_lockedzPluginManager._find_lockeds << ,- - /3||/F/F* %+FLL a * &* , *Ff}T\\444!%%f-99!!&) ** sB/pluginscKt|tr|n|g}|j|}tjd}|r.t d|j ddj|zS |D]$}t||j|j&t ddg S#t$r }t dt|cYd }~Sd }~wwxYww) zDisable a set of plugins (or an extension). Args: plugins: The list of plugins to disable Returns: The action result jupyterlaberrorz=The following plugins cannot be disabled as they are locked: , r-rSrrrAfrontendr-rVN) isinstancerWrr loadrRgettextjoinrrr Exceptionreprrrlockedtransrerrs rdisablezPluginManager.disables(6'WI""7+ -  S))F#$  C! Z!&d6F6FdjjY ZtJ<H H CwS B B C6A,C/6B&%C& C/C CC CCcKt|tr|n|g}|j|}tjd}|r.t d|j ddj|zS |D]$}t||j|j&t ddg S#t$r }t dt|cYd }~Sd }~wwxYww) zEnable a set of plugins (or an extension). Args: plugins: The list of plugins to enable Returns: The action result rrzd^>d^>& >  >& D $s) #&CU3S >%:C|C4CE#tCy.$9ClCrroc eZdZdZ ddeedeedeeddffd ZdZe de fd Z d e dee fd Z d e d ededeee efeeffdZd d e dee defdZd e defdZede de fdZd ede fdZ d!d ee d ededeeeeeffdZd ee d ededdfdZd"dZ d#dee effdZdedee fdZdeefdZde de fdZ d!d ee d ededdfdZ xZ!S)$ExtensionManageraBase abstract extension manager. Note: Any concrete implementation will need to implement the five following abstract methods: - :ref:`metadata` - :ref:`get_latest_version` - :ref:`list_packages` - :ref:`install` - :ref:`uninstall` It could be interesting to override the :ref:`get_normalized_name` method too. Args: app_options: Application options ext_options: Extension manager options parent: Configurable parent Attributes: log: Logger app_dir: Application directory core_config: Core configuration app_options: Application options options: Extension manager options Nrrwrxryc`t|||||jj|_t |jj |_|jj|_tdi|xsi|_ i|_ d|_ d|_ d|_ t|jjst|jj rt|jjdk(|_ |js=t|jj dkDr|jj#dt$j&j)|j*|jj,dzd|_ |jj/yy) N)rrwrxTrzqYou have define simultaneously blocked and allowed extensions listings. The allowed listing will take precedence.ig?) callback_timejitterrP)r{r|rloggerr}rapp_dir core_configr^r_extensions_cache_listings_cache_listings_block_mode_listing_fetchlenr_r`warningtornadoioloopPeriodicCallback_fetch_listingsrastart)rrrwrxrs rr|zExtensionManager.__init__Hs\ [kRXY##**D,,445 ++77.E+2CE GI/3$(!IM t||33 4DLL<`<`8a(+DLL,P,P(QUV(VD %,,T\\5Y5Y1Z]^1^  H#*.."A"A$$"llCCdJ#B#D     % % '9brcR|j|jjyyN)rstoprs r__del__zExtensionManager.__del__fs%    *    $ $ & +rct)zExtension manager metadata.NotImplementedErrorrs rmetadatazExtensionManager.metadatajs "##r extensioncKtw)zReturn the latest available version for a given extension. Args: pkg: The extension name Returns: The latest available version rrrs rget_latest_versionz#ExtensionManager.get_latest_versionos"## querypageper_pagecKtw)abList the available extensions. Args: query: The search extension query page: The result page per_page: The number of results per page Returns: The available extensions in a mapping {name: metadata} The results last page; None if the manager does not support pagination rrrrrs r list_packageszExtensionManager.list_packagesy"##rversioncKtw)aInstall the required extension. Note: If the user must be notified with a message (like asking to restart the server), the result should be {"status": "warning", "message": ""} Args: extension: The extension name version: The version to install; default None (i.e. the latest possible) Returns: The action result r)rrrs rr zExtensionManager.installs"##rcKtw)ajUninstall the required extension. Note: If the user must be notified with a message (like asking to restart the server), the result should be {"status": "warning", "message": ""} Args: extension: The extension name Returns: The action result rrs rr!zExtensionManager.uninstallrrc btjddtjdd|dS)a;Convert a Python version to Semver version. It: - drops ``.devN`` and ``.postN`` - converts ``aN``, ``bN`` and ``rcN`` to ``-alpha.N``, ``-beta.N``, ``-rc.N`` respectively Args: version: Version to convert Returns Semver compatible version z(a|b|rc)(\d+)$cXt|jd|jdS)Nrl)PYTHON_TO_SEMVERr+)ms rz5ExtensionManager.get_semver_version..s&)!''!*56qwwqzlCrz\.(dev|post)\d+r>r)resubsubn)rs rget_semver_versionz#ExtensionManager.get_semver_versions1vv  C GG&G 4Q 7  rc|jS)aNormalize extension name. Extension have multiple parts, npm package, Python package,... Sub-classes may override this method to ensure the name of an extension from the service provider and the local installed listing is matching. Args: extension: The extension metadata Returns: The normalized name )r%rs rget_normalized_namez$ExtensionManager.get_normalized_names~~rc&K||jvs||j|jvr|j|||d{|j.|j"|jj d{|j|j|}|i}t |j}|3|j&t |j}g}|jr|jD]n\}}||vr|jt|d'|js4|jjd|d|jt|dpn|jD]n\}}||vr|jt|d'|js4|jjd|d|jt|dp||j|jfS77w)aLList extensions for a given ``query`` search term. This will return the extensions installed (if ``query`` is None) or available if allowed by the listing settings. Args: query: [optional] Query search term. Returns: The extensions Last page of results NT)r8zBlocked extension 'z' is installed.FzNot allowed extension ')rrkrefreshrrcallbackrWrsrr(r*rr?r}rrm) rrrrrk extensionslistingr%exts rlist_extensionsz ExtensionManager.list_extensionss .. .$d>T>TUZ>[>a>a2a,,udH5 5 5    'D,?,?,K%%..0 0 0&&u-33D9 =E%,,.)  !5!5!A4//0GJ((!&GID#7*"))'#t*DE..((+>tfO)TU"))'#u*EF G"'GID#w"))'#t*DE..((+B4&)XY"))'#u*EF G411%8BBBB9 6 1s3AHH 9H<H=B3H1BH3AHHcK||jvrd|j|j|<|j|||d{y7w)zRefresh the list of extensions.N)rrk_update_extensions_listrs rrzExtensionManager.refreshsG D** *8&&&,,*ll;;JJqvv& QUU#7<=  >7<<& 1 <% =s8CH HCH  H!A H + H8 H H H cd K|j}t|}t|}t||i}|dj D]\}}d}|} |dj |drd}|j |} td)id| d| j dd d |j d d d ||d vdddtj|ddddtj|dd|d|j diddd|j|d|j dij d|j dd|j dd|j dij d d|j dij d |j d} |r.t| |j| jd{ } | || <|d!j D]\}}||d"vrd}|dj |drd}n|jD] } || vsd#} |j |} t| |j dd |d ||d vdtj|ddtj|d|d$|j||j dij d|j d|j d|j dij d |j dij d |j d%} |r.t| |j| jd{ } | || <|d&D]}|j|}||j |} t| |j dd |j d'd dddtj|dtj|dd#d|j dij d|j d|j d|j dij d |j dij d |j d(} | || <!|S77>w)*zGet the installed extensions. Args: get_latest_version: Whether to fetch the latest extension version or not. Returns: The installed extensions as a mapping {name: metadata} )rfederated_extensionsrArNrr%r5r>r6urlr<disabledr;Fr@rr=Tr?r-r r7prebuiltr:rBrCrDbugsrG repository)r@r shadowed_extsrsource)r%r5r6r<r;r@r=r?r-r7r:rBrCrDrGr!homepage)r%r5r6r=r<r;r@r?r-r7rBrCrDrGrP)rrr1rr(r_normalize_namer4rr_get_companionrrr%rs_get_scheduled_uninstall_info) rrrrbuild_check_inforr%datar-pkg_infonormalized_namepkgpackagess r_get_installed_extensionsz*ExtensionManager._get_installed_extensionss&&  4,[9dK0 56<<> .JD$FHO$((t4 "2248O"$$LL;"XXeR0T*%55    0BB4 ?S #3"E"Ed9o"VB/$--d3xx"-11&$((8:LM+!% 4 8 8 ? $xx b9==eTXXlE[\!C&"c8O8OPSPXPX8Y2YZ*-J '; .>|,224 .JD$tO,,FO$((t4  0 7 7 9+Hx'!*+#2248O"$ HH]B7!%[T*%55/BB4 ?S"2"E"Ed9o"V!--d3xx"-11&$((8:LM+ $ 4 8 8 ?#xx b9==eTXXlE[\C""c8O8OPSPXPX8Y2YZ*-J 'A .D%[1 2D55d;D"&"6"6t"<&( $ ;!%*b!9#!#3#F#FtI#W&6&I&I$y/&Z$'88Hb155fdhhx>PQ HHY/$(HHVR$8$<$"&h c## $hT4HSMXd^CCKM`c]`14`DG` `rr)(rKrr dataclassesrrrrpathlibrtypingrr r#jupyterlab_server.translation_utilsr traitletsr traitlets.configr r jupyterlab.commandsrrrrrrrcompiler'r1r4rRrYr^rfrjrorrPrrr.sY-  99":>#@<rzzGHJKbjjVW   $-)-)-)` $ ; ; ;  $    $ A2 A A  $ ' ' '     tC'tCnF`}F`r