o iW@s>dZddlZddlZddlmZmZmZddlmZddl m Z m Z m Z m Z mZddlZddlmZmZddlmZmZmZmZmZdd d d Zd d ZedededdZddZeddGdddZeddGdddZeGdddZ eddGdddZ!eGdddZ"Gd d!d!eZ#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.)abrccCst|}||d<dS)z0Ensure that the app info has compat_errors field compat_errorsN)r _get_extension_compat)info app_optionshandlerrX/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/jupyterlab/extensions/manager.py_ensure_compat_errorssrz*(?P.*) needs to be included in buildz+(?P.*) needs to be removed from buildz:(?P.*) changed from (?P.*) to (?P.*)install uninstallupdatecCsbt|}|jdd}gggd}|D]}tD]\}}||}|r-|||dqq|S)z8Get info about packages scheduled for (un)install/updateT)fastrname)r build_check _message_mapitemsmatchappendgroup)rrmessagesstatusmsgkeypatternr&rrr_build_check_info's   r.T)frozenc@seZdZUdZeed<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__r4boolr5r6rr7r8rdictr9r;r<r*r>r?r@rArBrCrrrrr05s,        r0c@s@eZdZUdZeed<dZeeed<ee dZ 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) rDrErFrGrHrIrMrrlistrPrrrrrrLfs  rLc@s\eZdZUdZeedZeee d<eedZ eee d<dZ e e d<ee dZe 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 rNallowed_extensions_urisblocked_extensions_urisilistings_refresh_secondslistings_tornado_optionsN)rDrErFrGrsetrSr rHrIrTrUintrKrVrrrrrRws   rRc@s6eZdZUdZeed<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) rDrErFrGrHrIrZrJr[rrrrrrYs  rYc@sDeZdZUdZeedZeee ee e ffe d<dZ ee d<dS)ExtensionsCachez{Extensions cache Attributes: cache: Extension list per page last_page: Last available page result rNcache last_pageN)rDrErFrGrrKr]rrXrrHr0rIr_rrrrr\s &r\c seZdZdZ   d7deedeedeeddffdd Zd d Ze de fd d Z d e dee fddZ de dededeee efeeffddZd8d e dee defddZd e defddZd e defddZd e defddZede de fddZd ede fd d!Z #d9dee dededeeeeeffd$d%Zdee dededdfd&d'Zd:d(d)Z *d;dee effd+d,Zd-edee fd.d/Z deefd0d1Z!d2e de fd3d4Z" #d9dee dededdfd5d6Z#Z$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_optionsparentreturncstj|dt|}|j|_t|j|_|j|_||_t di|p"i|_ i|_ d|_ d|_ d|_t|j js>t|j jrnt|j jdk|_ |j sXt|j jdkrX|jdtjj|j|j jddd|_|jdSdS) N)rbTrzqYou have define simultaneously blocked and allowed extensions listings. The allowed listing will take precedence.ig?) callback_timejitterr)super__init__rloggerlograpp_dir core_configrrRoptions_extensions_cache_listings_cache_listings_block_mode_listing_fetchlenrSrTwarningtornadoioloopPeriodicCallback_fetch_listingsrUstart)selfrrarb __class__rrrgs0  zExtensionManager.__init__cCs|jdur |jdSdSN)rpstoprxrrr__del__s zExtensionManager.__del__cCst)zExtension manager metadata.NotImplementedErrorr}rrrmetadataszExtensionManager.metadata extensionct)zReturn the latest available version for a given extension. Args: pkg: The extension name Returns: The latest available version rrxrrrrget_latest_versionsz#ExtensionManager.get_latest_versionquerypageper_pagecr)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 rrxrrrrrr list_packages zExtensionManager.list_packagesversioncr)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)rxrrrrrrszExtensionManager.installcr)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 rrrrrrrzExtensionManager.uninstallc Vzt||jdtddgdWSty*}ztdt|dWYd}~Sd}~ww)zDisable an extension. Args: extension: The extension name Returns: The action result rr=frontendr*rPerrorr*rMN)rrrL Exceptionreprrxrerrrrrdisable!zExtensionManager.disablec r)zEnable an extension. Args: extension: The extension name Returns: The action result rr=rrrrN)rrrLrrrrrrenable/rzExtensionManager.enablec Cs tdddtdd|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+)$cSst|d|dS)Nr^)PYTHON_TO_SEMVERr()mrrrMsz5ExtensionManager.get_semver_version..z\.(dev|post)\d+r:r)resubsubn)rrrrget_semver_version=s z#ExtensionManager.get_semver_versioncCs|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"rrrrget_normalized_nameQs z$ExtensionManager.get_normalized_namer^c sh||jvs||j|jvr||||IdH|jdur*|jdur*|jIdH|j|j|}|dur8i}t|}|dur|jdurt|j}g}|jr| D](\}}||vrg| t |ddqU|j r}|j d|d| t |ddqUn-| D](\}}||vr| t |ddq|j r|j d|d| t |ddq||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)r4zBlocked extension 'z' is installed.FzNot allowed extension ')rmr]refreshrnrpcallbackrQvaluesror%r'rr;rirrr_) rxrrrr] extensionslistingr"extrrrlist_extensions`s:  z ExtensionManager.list_extensionscs4||jvrd|j|j|<||||IdHdS)zRefresh the list of extensions.N)rmr]_update_extensions_listrrrrrs zExtensionManager.refreshcsg}tj}|jrAt|jjr@|jd|jj|jjD]}|j |fi|jj IdH}t |j }||dgq n5t|jjrv|jd|jj|jjD]}|j |fi|jj IdH}t |j }||dgqVdd|D|_dS)z-Fetch the listings for the extension manager.z!Fetching blocked extensions from Nblocked_extensionsz!Fetching allowed extensions from allowed_extensionscSsi|]}|d|qSrr).0rrrr sz4ExtensionManager._fetch_listings..)rs httpclientAsyncHTTPClientrorqrlrTrirfetchrVjsonloadsbodyextendgetrSrn)rxrulesclientblocked_extensions_urirjallowed_extensions_urirrrrvs<         z ExtensionManager._fetch_listingsTc sN|j}t|d}t|}t||i}|dD]\}}d}|} |d|dr,d}||} td)id| d| dd d |d d d ||d vdddt |ddddt |dd|d|diddd| |d|did|dd|dd|did d|did |d} |rt | | | j IdHd } | || <q|d!D]\}}||d"vrqd}|d|drd}n |D]} || vrd#}q||} t| |dd |d ||d vdt |ddt |d|d$| ||did|d|d|did |did |dd%} |rAt | | | j IdHd } | || <q|d&D]Z}||}|dur||} t| |dd |d'd dddt |dt |dd#d|did|d|d|did |did |dd(} | || <qJ|S)*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_extensionsr=rNrr"r1r:r2urlr8disabledr7Fr<rr9Tr;r*rr3prebuiltr6r>r?r@bugsrC repository)r<r shadowed_extsrrsource)r"r1r2r8r7r<r9r;r*r3r6r>r?r@rCrhomepage)r"r1r2r9r8r7r<r;r*r3r>r?r@rCr)rrr.rr%r_normalize_namer0r`r_get_companionrrr"r_get_scheduled_uninstall_info) rxrrrbuild_check_inforr"datar*pkg_infonormalized_namepkgpackagesrrr_get_installed_extensionss                             z*ExtensionManager._get_installed_extensionsrcCs@d}d|dvrd|ddvrd}|Sd|ddvrd}|S)N discovery jupyterlabserverkernelr)rxrr6rrrrs zExtensionManager._get_companioncCsX|jdd|d}|r*| }t|WdS1s#wYdSdS)zDGet information about a package that is scheduled for uninstallationstaging node_modulesz package.jsonN)rjexistsopenrload)rxr"targetfidrrrr%s  $z.ExtensionManager._get_scheduled_uninstall_infor"cCs|S)zNormalize extension name; by default does nothing. Args: name: Extension name Returns: Normalized name r)rxr"rrrr.sz ExtensionManager._normalize_namecsd}|dur||||IdH\}}n|IdH}||jvr2||j|j|<|p+d|j|_dSt||i|p9d|j|<dS)zUpdate the list of extensionsNr^)rrrmr]r_r\)rxrrrr_rrrrr8s z(ExtensionManager._update_extensions_list)NNNr{)Nr^r)rcN)T)%rDrErFrGrrKr rgr~propertyrYrrHrrXr rr0rrLrrrr staticmethodrrrrrrvrrrrr __classcell__rrryrr`s~    .   j   r`)$rGrr dataclassesrrrpathlibrtypingrrrr r rstraitlets.configr r jupyterlab.commandsr rrrrrrcompiler$r.r0rLrRrYr\r`rrrrs6  0