Mh hdZddlZddlZddlmZmZmZmZddlm Z ddl m Z m Z ddl Z ddlmZddlmZddlmZmZdd lmZmZmZmZmZd d d d ZdZejdejdejddZdZedGddZ edGddZ!edGddZ"edGdde"Z#edGddZ$eGd d!Z%Gd"d#eZ&Gd$d%e&Z'dS)&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.)abrccRt|}||d<dS)z0Ensure that the app info has compat_errors field compat_errorsN)r_get_extension_compat)info app_optionshandlers ]/var/www/html/test/jupyter/venv/lib/python3.11/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 uninstallupdatec.t|}|d}gggd}|D]f}tD]J\}}||}|r.|||dKg|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" ; ;F88(..00 8 8LCMM#&&E 8s ""5;;v#6#6777 8 MrT)frozenceZdZUdZeed<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<d S)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-rBrCrDrErFrGrrr4r47so2 IIIMMMGTHd#Ix}###D$GT"GXd^""" $Ix~$$$sNCFC FHSM   !GXc]!!!%)OXc])))'+x}+++)-#---$(NHSM(((((rr4cfeZdZUdZeed<dZeeed<ee Z e eed<dS) 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\ KKK!GXc]!!!$uT:::M49:::::rrRcPeZdZUdZeeZeeed<dZ e ed<dS)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[rNrPrrrYrYysO"'y!A!A!AJ #AAAHdrrYceZdZUdZeeZeeed<eeZ eeed<dZ e ed<ee Z e ed<dS) 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^s).c(B(B(BSXBBB(-c(B(B(BSXBBB$+c+++%*U4%@%@%@d@@@@@rr^cFeZdZUdZeed<dZeed<dZe eed<dS)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) rHrIrJrKrLrMrgrNrhrrPrrrfrfsK IIIK"&L(3-&&&&&rrfcpeZdZUdZeeZeeeee e ffe d<dZ ee d<dS)ExtensionsCachez{Extensions cache Attributes: cache: Extension list per page last_page: Last available page result rTcache last_pageN) rHrIrJrKrrOrkrdrrLr4rMrmrPrrrjrjsg?DeTX>Y>Y>YE4Xd3(8#89:: ;YYYIsrrjc 4eZdZdZegddddZ 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_optionsparentreturncxt||jd|jjd|jdt||_dttDfd|pi D}tdi||_ dS)N)rxz Plugins in z will managed on the z levelch|] }|j SrPr%).0fs r z)PluginManager.__init__..sMMM1MMMrc$i|] \}}|v || SrPrP)r}optionvalueplugin_options_fields r z*PluginManager.__init__..s5   --- E---rrP) super__init__logdebug __class__rHlevelrrrrYr(options)selfrrwrxplugin_optionsrrs @rrzPluginManager.__init__s '''  Z$.1 Z Z Z Z Z   +;77MM7K0L0LMMM    "-"3!:!:!.s6* * * %+FLL  a * * * rr)rr[rcrZadd)rr locked_subsetextensions_with_locked_pluginsrs r _find_lockedzPluginManager._find_lockeds <  .,-- - * * /3|/F* * * &, * *Ff}}T\444!%%f---999!!&)))rpluginscKt|tr|n|g}||}tjd}|r:t d|dd|zS |D]}t||j |j t ddg S#t$r(}t dt|cYd }~Sd }~wwxYw) 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$(66E''WI""7++ --   S))F##$  C! Z Z!&d6FdjYYYYYtJ<HHH H C C CwS BBB B B B B B B C2B66 C(C#C(#C(cKt|tr|n|g}||}tjd}|r:t d|dd|zS |D]}t||j |j t ddg S#t$r(}t dt|cYd }~Sd }~wwxYw) zEnable a set of plugins (or an extension). Args: plugins: The list of plugins to enable Returns: The action result rrz>d^>d^>& >  >>>>>>& D    $s) #&CU3S >%:C|CCCC4CE#tCy.$9ClCCCCCCCCrroc LeZdZdZ d"deedeedeeddffd 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 fd Z d$d ee d ededdfd!Z 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 Nrrwrxryct||||jj|_t |jj|_|jj|_tdi|pi|_ i|_ d|_ d|_ d|_ t|j jst|j jrt|j jdk|_ |j s7t|j jdkr|jdt$j|j|j jdzd|_ |j dSdS) N)rrwrxTrzqYou have define simultaneously blocked and allowed extensions listings. The allowed listing will take precedence.ig?) callback_timejitterrP)rrrloggerrrapp_dir core_configr^r_extensions_cache_listings_cache_listings_block_mode_listing_fetchlenr_r`warningtornadoioloopPeriodicCallback_fetch_listingsrastart)rrrwrxrs rrzExtensionManager.__init__Hsu [kRXYYY#*D,455 +7.EE+2CEE GI/3$(!IM t|3 4 4 (DL<`8a8a ((+DL,P(Q(QUV(VD %, T\5Y1Z1Z]^1^1^  H#*."A"A$"lCdJ#B##D    % % ' ' ' ' ' ( (rcJ|j|jdSdSN)rstoprs r__del__zExtensionManager.__del__fs.   *   $ $ & & & & & + *rct)zExtension manager metadata.NotImplementedErrorrs rmetadatazExtensionManager.metadatajs"###r extensionc"Kt)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"###rquerypageper_pagec"Kt)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"###rversionc"Kt)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"###rc"Kt)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 dtjddtjdd|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+)$cpt|d|dS)Nrl)PYTHON_TO_SEMVERr+)ms rz5ExtensionManager.get_semver_version..s+)!''!**5CqwwqzzCCrz\.(dev|post)\d+r>r)resubsubn)rs rget_semver_versionz#ExtensionManager.get_semver_versions8v  C C G&G 4 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 ~rrlcK||jvs||j|jvr||||d{V|j&|j|jd{V|j|j|}|i}t |}|>|j6t |j}g}|jr| D]w\}}||vr%| t|d.|j rB|j d|d| t|dxn| D]w\}}||vr%| t|d.|j rB|j d|d| t|dx||j|jfS)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?rrrm) rrrrrk extensionslistingr%exts rlist_extensionsz ExtensionManager.list_extensionssE . . .$d>TUZ>[>a2a2a,,udH55 5 5 5 5 5 5 5   'D,?,K%..00 0 0 0 0 0 0 0&u-3D9 =E%,,..))  !5!A4/00GJ( G!&GGID#7**"))'#t*D*D*DEEEE.G(()Tt)T)T)TUUU"))'#u*E*E*EFFF G"'GGID#w"))'#t*D*D*DEEEE.G(()X4)X)X)XYYY"))'#u*E*E*EFFF41%8BBBrcK||jvrd|j|j|<||||d{VdS)zRefresh the list of extensions.N)rrk_update_extensions_listrs rrzExtensionManager.refreshsY D* * *8.s<<<& 1<<4<788 B ^ 8\^^/3l.RBB**fl.,?A 16**ALL';R!@!@AAAA 5 6 6 > HMMZDL4XZZ   +/,*N > >&&&,*l;Jqv&& QUU#7<<====<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&  444,[99dK000 56<<>> . .JD$FHO$((t44 ! "22488O"$_$LL;;;"XXeR000T*%555  U  0BB4 ?SSS $#3"E"Ed9o"V"V"VvB///$--d333xx"--11&$((8:L:LMMM+++!% 4 4 8 8 ? ? ? $xx b99==eTXXlE[E[\\\!C&" [c8O8OPSPX8Y8Y2Y2Y2Y2Y2Y2YZZZ*-J ' '|,2244 . .JD$tO,,,FO$((t44 +  0 7 7 9 9++Hx''!*"22488O"$ HH]B77!%[T*%55/BB4 ?SS"2"E"Ed9o"V"V!--d33xx"--11&$((8:L:LMM++ $ 4 4 8 8 ? ?#xx b99==eTXXlE[E[\\C"" [c8O8OPSPX8Y8Y2Y2Y2Y2Y2Y2YZZZ*-J ' '$[1 2 2D55d;;D"&"6"6t"<"<&( $ ; ;!%*b!9!9#!#3#F#FtI#W#W&6&I&I$y/&Z&Z$'88Hb1155fdhhx>P>PQQ HHY//$(HHVR$8$8$<$"&hh c## $hhhhT4HSMXd^CCKM``c]`14`DG` ````````rr)(rKrr dataclassesrrrrpathlibrtypingrr r#jupyterlab_server.translation_utilsr traitletsr traitlets.configr r jupyterlab.commandsrrrrrrrcompiler'r1r4rRrYr^rfrjrorrPrrr5st--  999999999999""""""""::::::>>>>>>>>#@@<<<rzGHHJKKbjVWW     $-)-)-)-)-)-)-)-)` $ ; ; ; ; ; ; ; ;  $         $ A A A A A2 A A A  $ ' ' ' ' ' ' ' '          tCtCtCtCtC'tCtCtCnF`F`F`F`F`}F`F`F`F`F`r