@eW,dZddlZddlZddlmZmZmZddlmZddl m Z m Z m Z m Z mZddlZddlmZmZddlmZmZmZmZmZdd d d Zd Zejd ejdejddZdZedGddZedGddZeGddZ edGddZ!eGddZ"GddeZ#dS) z'Base classes for the extension manager.N) dataclassfieldreplace)Path)DictListOptionalSetTuple) 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 =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:r r;r<r dictr=r?r@r-rBrCrDrErFrGrrr4r45so2 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) rHrIrJrKrLrMrSr rlistrVrrPrrrRrRfs\ KKK!GXc]!!!$uT:::M49:::::rrRceZdZUdZeeZeee d<eeZ eee d<dZ e e d<ee Ze e d<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)rHrIrJrKrsetrZr rLrMr[r\intrOr]rPrrrYrYws).c(B(B(BSXBBB(-c(B(B(BSXBBB$+c+++%*U4%@%@%@d@@@@@rrYcFeZdZUdZeed<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) rHrIrJrKrLrMrbrNrcr rPrrrarasK IIIK"&L(3-&&&&&rracpeZdZUdZeeZeee ee 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)rHrIrJrKrrOrfrr_r rLr4rMrhrPrrreresg?DeTX>Y>Y>YE4Xd3(8#89:: ;YYYIsrrec leZdZdZ d$deedeedeeddffd ZdZe de fd Z d e dee fd Z d e d ededeee efeeffdZd%d e dee defdZd e defdZd e defdZd e defdZede de fdZd ede fdZ d&d ee d ededeeeeeffdZd ee d ededdfdZd'dZ d(dee effdZdedee fdZ deefd Z!d!e 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 Nr ext_optionsparentreturnct|t|}|j|_t |j|_|j|_||_tdi|pi|_ i|_ d|_ d|_ d|_t|j jst|j jrt|j jdk|_ |j s7t|j jdkr|jdt&j|j|j jdzd|_|jdSdS) N)rlTrzqYou have define simultaneously blocked and allowed extensions listings. The allowed listing will take precedence.ig?) callback_timejitterrP)super__init__rloggerlograpp_dir core_configrrYoptions_extensions_cache_listings_cache_listings_block_mode_listing_fetchlenrZr[warningtornadoioloopPeriodicCallback_fetch_listingsr\start)selfrrkrl __class__s rrrzExtensionManager.__init__s| '''%k22 %K/00 &2&.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)r{stoprs r__del__zExtensionManager.__del__s.   *   $ $ & & & & & + *rct)zExtension manager metadata.NotImplementedErrorrs rmetadatazExtensionManager.metadatas"###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_versions"###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_packages"###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.uninstallrrcK t||jtddgS#t$r(}tdt |cYd}~Sd}~wwxYw)zDisable an extension. Args: extension: The extension name Returns: The action result rrAfrontendr-rVerrorr-rSN)rrrR Exceptionreprrrerrs rdisablezExtensionManager.disable!s C iT5E F F F FtJ<HHH H C C CwS BBB B B B B B B C', AAAAcK t||jtddgS#t$r(}tdt |cYd}~Sd}~wwxYw)zEnable an extension. Args: extension: The extension name Returns: The action result rrArrrrN)rrrRrrrs renablezExtensionManager.enable/s C YD4D E E E EtJ<HHH H C C CwS BBB B B B B B B Crc 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)Nrg)PYTHON_TO_SEMVERr+)ms rz5ExtensionManager.get_semver_version..Ms+)!''!**5CqwwqzzCCrz\.(dev|post)\d+r>r)resubsubn)rs rget_semver_versionz#ExtensionManager.get_semver_version=s8v  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_nameQs ~rrgcK||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 ')rxrfrefreshryr{callbackrWvaluesrzr(r*rr?rtr}rh) rrrrrf extensionslistingr%exts rlist_extensionsz ExtensionManager.list_extensions`sE . . .$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)rxrf_update_extensions_listrs rrzExtensionManager.refreshsY D* * *8z4ExtensionManager._fetch_listings..s<<<& 1<<4<788 B ^ 8\^^/3l.RBB**fl.,?A 16**ALL';R!@!@AAAA 5 6 6 > HMM[T\5Y[[   +/,*N > >&&&,*l;Jqv&& QUU#7<<====<r6urlr<disabledr;Fr@rr=Tr?r-r r7prebuiltr:rBrCrDbugsrG repository)r@r shadowed_extsr}source)r%r5r6r<r;r@r=r?r-r7r:rBrCrDrGr!homepage)r%r5r6r=r<r;r@r?r-r7rBrCrDrGrP)rrr1rr(r_normalize_namer4rjr_get_companionrrr%r_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` ````````rrj)$rKrr dataclassesrrrpathlibrtypingrrr r r r~traitlets.configr r jupyterlab.commandsrrrrrrrcompiler'r1r4rRrYrarerjrPrrrs--  111111111133333333333333>>>>>>>>#@@<<<rzGHHJKKbjVWW     $-)-)-)-)-)-)-)-)` $ ; ; ; ; ; ; ; ;   A A A A A A A  A  $ ' ' ' ' ' ' ' '          d`d`d`d`d`*d`d`d`d`d`r