a
    ø£BeÑO ã                   @   sî  d Z ddlZddlZddlZddlZddlZddlZddlZddlm	Z
 ddlZddlZddlZddlZddlZddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd	lmZmZm Z m!Z! dd
l"m#Z# ddl$m%Z%m&Z&m'Z'm(Z( ddl)m*Z*m+Z+m,Z,m-Z-m.Z. ddl/m0Z0m1Z1m2Z2m3Z3 ddl4m5Z5 ddl6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z< ddl=m>Z> ddl?m@Z@ ddlAmBZBmCZC ddlDmEZEmFZFmGZGmHZHmIZImJZJ e Kd¡ZLe
 Me
 NeBd¡¡ZOe
 NeOd¡ZPdZQdZRG dd„ de0ƒZSdd„ ZTdd„ ZUdd „ ZVd!d"„ ZWd‰d#d$„ZXdŠd%d&„ZYd‹d'd(„ZZdŒd)d*„Z[d+d,„ Z\d�d-d.„Z]dŽd/d0„Z^G d1d2„ d2e8ƒZ_d3d4„ Z`d�d5d6„Zad�d7d8„Zbd‘d:d;„Zcd’d<d=„Zdd“d>d?„Zed”dAdB„Zfd•dCdD„Zgd–dFdG„Zhd—dHdI„Zid˜dJdK„Zjd™dLdM„ZkdšdNdO„Zld›dPdQ„ZmdœdRdS„Znd�dTdU„ZodždVdW„ZpdXdY„ ZqG dZd[„ d[ƒZrd\d]„ Zsd^d_„ ZtdŸd`da„Zudbdc„ Zvddde„ Zwdfdg„ Zxdhdi„ Zydjdk„ Zzdldm„ Z{dndo„ Z|dpdq„ Z}d drds„Z~d¡dtdu„Zd¢dvdw„Z€dxdy„ Z�dzd{„ Z‚d|d}„ Zƒd~d„ Z„d€d�„ Z…d‚dƒ„ Z†d£d„d…„Z‡d†d‡„ Zˆe‰dˆk�rêe^eBƒ dS )¤zJupyterLab command handleré    N)Údeepcopy)Úglob)ÚPath)ÚTemporaryDirectory)ÚEvent)ÚURLError)ÚRequestÚquoteÚurljoinÚurlopen)Újupyter_config_dir)ÚGREEN_ENABLEDÚGREEN_OKÚRED_DISABLEDÚRED_X)Úget_federated_extensionsÚget_package_urlÚget_page_configÚget_static_page_configÚwrite_page_config)ÚProcessÚWatchHelperÚlist2cmdlineÚwhich)ÚVersion)ÚBoolÚ	HasTraitsÚInstanceÚListÚUnicodeÚdefault)Ú__version__©Ú
CoreConfig)ÚHEREÚ	YARN_PATH)ÚRangeÚgtÚgteÚltÚlteÚmake_semverz'.*theme-light-extension/style/theme.cssz..Údev_modezpin@zhttps://registry.yarnpkg.comc                   @   s   e Zd Zddd„Zdd„ ZdS )ÚProgressProcessNc                 C   s–   t |ttfƒsd}t|ƒ‚|r2| ¡ r2d}t|ƒ‚t|ƒ| _d| _|| _| j 	dt
|ƒ› �¡ | j||tjtjddd�| _|p‚tƒ | _tj | ¡ dS )	aã  Start a subprocess that can be run asynchronously.

        Parameters
        ----------
        cmd: list
            The command to run.
        logger: :class:`~logger.Logger`, optional
            The logger instance.
        cwd: string, optional
            The cwd of the process.
        kill_event: :class:`~threading.Event`, optional
            An event used to kill the process operation.
        env: dict, optional
            The environment for the process.
        zCommand must be given as a listzProcess abortedÚ z> Túutf-8)ÚcwdÚenvÚstderrÚstdoutÚuniversal_newlinesÚencodingN)Ú
isinstanceÚlistÚtupleÚ
ValueErrorÚis_setÚ_ensure_loggerÚloggerZ
_last_lineÚcmdÚdebugr   Z_create_processÚ
subprocessÚSTDOUTÚPIPEÚprocr   Ú_kill_eventr   Z_procsÚadd)Úselfr=   r<   r0   Ú
kill_eventr1   Úmsg© rH   úV/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/jupyterlab/commands.pyÚ__init__C   s(    
úzProgressProcess.__init__c                 C   sÊ   g }| j }| j}t g d¢¡}| ¡ d u r¦tj t|ƒ¡ tj 	¡  tj d¡ | 
¡ rl|  ¡  d}t|ƒ‚z|jdd�\}}| |¡ W q tjy¢   Y qY q0 q| j d |¡¡ tj 	¡  |  ¡ S )N)ú-ú\ú|ú/úzProcess was abortedgš™™™™™¹?)ÚtimeoutÚ
)rB   rC   Ú	itertoolsÚcycleÚpollÚsysr3   ÚwriteÚnextÚflushr:   Ú	terminater9   ÚcommunicateÚappendr?   ÚTimeoutExpiredr<   r>   Újoin)rE   ÚcacherB   rF   ÚspinnerrG   ÚoutÚ_rH   rH   rI   Úwaitl   s(    

zProgressProcess.wait)NNNN)Ú__name__Ú
__module__Ú__qualname__rJ   rb   rH   rH   rH   rI   r-   B   s   
)r-   c                  G   s   t  t j| Ž ¡S )z!Join paths to create a real path.)ÚospÚabspathr]   )ÚargsrH   rH   rI   Úpjoinƒ   s    ri   c                  C   s(   t j d¡} | pttƒ ddƒ} t | ¡S )z6Get the configured JupyterLab user settings directory.ZJUPYTERLAB_SETTINGS_DIRÚlabzuser-settings©ÚosÚenvironÚgetri   r   rf   rg   )Zsettings_dirrH   rH   rI   Úget_user_settings_dirˆ   s    ro   c                  C   s(   t j d¡} | pttƒ ddƒ} t | ¡S )z3Get the configured JupyterLab workspaces directory.ZJUPYTERLAB_WORKSPACES_DIRrj   Z
workspacesrk   )Zworkspaces_dirrH   rH   rI   Úget_workspaces_dir�   s    rp   c                  C   s¨   t j d¡r"ttt jd ƒ ¡ ƒS ttjdddƒ} t	t
dƒrDt
 ¡  tt
ddƒ}t |¡rt|  |¡stt|dddƒ} n$tj d¡r˜t | ¡s˜t d	¡r˜d	} tt| ƒ ¡ ƒS )
z,Get the configured JupyterLab app directory.ZJUPYTERLAB_DIRÚshareÚjupyterrj   ÚgetuserbaseÚ	USER_BASENz/usrz/usr/local/share/jupyter/lab)rl   rm   rn   Ústrr   Úresolveri   rU   ÚprefixÚhasattrÚsiters   Úgetattrr$   Ú
startswithrf   Úexists)Úapp_dirÚuserbaserH   rH   rI   Úget_app_dir–   s     

ÿþýr   c                 C   sF   t dtdddddg| |d� ¡ dk}|rBt dtg| |d�}| ¡  d	S )
a>  `yarn-deduplicate` with the `fewer` strategy to minimize total
    packages installed in a given staging directory

    This means a extension (or dependency) _could_ cause a downgrade of an
    version expected at publication time, but core should aggressively set
    pins above, for example, known-bad versions
    ÚnodeZdlxzyarn-berry-deduplicatez-sZfewerHighestz--fail©r0   r<   r   N)r-   r%   rb   )Úpathr<   Z	had_dupesÚ	yarn_procrH   rH   rI   Údedupe_yarn¶   s$    	ù	õóÿr„   c                 C   sZ   t |ƒ}tdtddg| |d�}| ¡ }|dkrRtdtg| |d�}| ¡  tt|ƒ |dkS )z_Ensure that node_modules is up to date.

    Returns true if the node_modules was updated.
    r€   z--immutablez--immutable-cacher�   r   )r;   r-   r%   rb   r„   Ú	REPO_ROOT)r0   r<   rƒ   ÚretrH   rH   rI   Úensure_node_modulesÔ   s    ÿ
r‡   c                 C   sF   t | ƒ} ttdƒ}tt| ƒs&t |¡sBtdtdgt| d�}| 	¡  dS )z)Ensure that the dev assets are available.Ústaticr€   Úbuildr�   N)
r;   ri   ÚDEV_DIRr‡   r…   rf   r|   r-   r%   rb   )r<   Útargetrƒ   rH   rH   rI   Ú
ensure_devè   s
    
rŒ   c                 C   sR   t tdƒ}t| ƒ} t tddƒ}t |¡sNt|| ƒ tdtdg|| d�}| ¡  dS )z*Ensure that the core assets are available.Ústagingrˆ   ú
index.htmlr€   r‰   r�   N)	ri   r$   r;   rf   r|   r‡   r-   r%   rb   )r<   r�   r‹   rƒ   rH   rH   rI   Úensure_coreó   s    


r�   c                 C   s&   t  t| ddƒ¡rdS d|  dg}|S )z€Ensure that an application directory is available.

    If it does not exist, return a list of messages to prompt the user.
    rˆ   rŽ   Nz/JupyterLab application assets not found in "%s"z?Please run `jupyter lab build` or use a different app directory)rf   r|   ri   )r}   ÚmsgsrH   rH   rI   Ú
ensure_app   s    þr‘   c                 C   sH   t | ƒ} tt| ƒ t t tdd¡¡}d}tdtddg|| |d�}|gS )zÔRun watch mode for the source packages.

    Parameters
    ----------
    logger: :class:`~logger.Logger`, optional
        The logger instance.

    Returns
    -------
    A list of `WatchHelper` objects.
    ÚpackagesZmetapackagez/.* Found 0 errors\. Watching for file changes\.r€   ÚrunÚwatch©r0   r<   Ústartup_regex)r;   r‡   r…   rf   rg   r]   r   r%   )r<   Zts_dirZts_regexZts_procrH   rH   rI   Úwatch_packages  s    
ÿr—   c                 C   s4   t | ƒ} t| ƒ}tdtddgt| td�}g |¢|‘S )zÑRun watch mode in a given directory.

    Parameters
    ----------
    logger: :class:`~logger.Logger`, optional
        The logger instance.

    Returns
    -------
    A list of `WatchHelper` objects.
    r€   r“   r”   r•   )r;   r—   r   r%   rŠ   ÚWEBPACK_EXPECT)r<   Úpackage_procsZwp_procrH   rH   rI   Ú	watch_dev)  s    
ürš   c                       sÐ   e Zd ZdZd‡ fdd„	Zedd�Zeddd�Ze	e
jd	d�Ze	ed
d�Ze	eddd�Zeeƒ dd�Zedd�Zeddd�Zeddd�Zedƒdd„ ƒZedƒdd„ ƒZedƒdd„ ƒZedƒdd„ ƒZ‡  ZS ) Ú
AppOptionszOptions object for build systemNc                    sP   |d ur||d< |d ur ||d< d|v r:|d s:|  d¡ tƒ jf i |¤Ž d S )NÚcore_configr<   r}   )ÚpopÚsuperrJ   )rE   r<   rœ   Úkwargs©Ú	__class__rH   rI   rJ   G  s    
zAppOptions.__init__zThe application directory)ÚhelpTzKWhether to shadow the default app_dir if that is set to a non-default valuezThe logger to usezConfiguration for core datarH   zEvent for aborting call)rh   r¢   z7The paths to look in for prebuilt JupyterLab extensionszNPM packages registry URLFz*Splice source packages into app directory.zŒIf true, perform only a quick check that the lab build is up to date. If false, perform a thorough check, which verifies extension contents.r<   c                 C   s
   t  d¡S )NÚ
jupyterlab©ÚloggingÚ	getLogger©rE   rH   rH   rI   Ú_default_loggerp  s    zAppOptions._default_loggerr}   c                 C   s   t ƒ S ©N)r   r§   rH   rH   rI   Ú_default_app_dirv  s    zAppOptions._default_app_dirrœ   c                 C   s   t ƒ S r©   r"   r§   rH   rH   rI   Ú_default_core_configz  s    zAppOptions._default_core_configÚregistryc                 C   s   t | jƒd }| dt¡S )Núyarn configr¬   )Ú_yarn_configr<   rn   ÚYARN_DEFAULT_REGISTRY©rE   ÚconfigrH   rH   rI   Ú_default_registry~  s    zAppOptions._default_registry)NN)rc   rd   re   Ú__doc__rJ   r   r}   r   Úuse_sys_dirr   r¥   ÚLoggerr<   r#   rœ   r   rF   r   Úlabextensions_pathr¬   Úsplice_sourceÚskip_full_build_checkr    r¨   rª   r«   r²   Ú__classcell__rH   rH   r    rI   r›   D  s6   
þÿ
ý


r›   c                 C   s0   | du rt ƒ S t| jt ƒr| S t f i | ¤ŽS dS )z-Helper to use deprecated kwargs for AppOptionN)r›   Ú
issubclassr¡   )ÚoptionsrH   rH   rI   Ú_ensure_options„  s
    r¼   c                 C   s:   t | ƒ} t| jƒ t| ƒ}| jr*t| jƒng }|| ¡  S )zÒWatch the application.

    Parameters
    ----------
    app_options: :class:`AppOptions`, optional
        The application options.

    Returns
    -------
    A list of processes to run asynchronously.
    )r¼   Ú_node_checkr<   Ú_AppHandlerr·   r—   r”   )Úapp_optionsÚhandlerr™   rH   rH   rI   r”   Ž  s
    
r”   c                 C   s(   t |ƒ}t|jƒ t|ƒ}|j| |d�S )z�Install an extension package into JupyterLab.

    The extension is first validated.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    ©Úpin)r¼   r½   r<   r¾   Úinstall_extension)Ú	extensionr¿   rÂ   rÀ   rH   rH   rI   rÃ   £  s    
rÃ   Fc                 C   s4   t |ƒ}t|jƒ t|ƒ}|du r*| ¡ S | | ¡S )zpUninstall an extension by name or path.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    T)r¼   r½   r<   r¾   Úuninstall_all_extensionsÚuninstall_extension)Únamer¿   Úall_rÀ   rH   rH   rI   rÆ   °  s    
rÆ   c                 C   s4   t |ƒ}t|jƒ t|ƒ}|du r*| ¡ S | | ¡S )z÷Update an extension by name, or all extensions.
    Either `name` must be given as a string, or `all_` must be `True`.
    If `all_` is `True`, the value of `name` is ignored.
    Returns `True` if a rebuild is recommended, `False` otherwise.
    T)r¼   r½   r<   r¾   Úupdate_all_extensionsÚupdate_extension)rÇ   rÈ   r}   r¿   rÀ   rH   rH   rI   rÊ   ½  s    
rÊ   c                    s  t ˆ ƒ‰ ˆ j}ˆ j}| d|¡ |ttdƒkr:d}t|ƒ‚|ttdƒkrTd}t|ƒ‚tˆ ddƒrx| d|¡ t||ƒ n\g d	¢}‡ fd
d„|D ƒ}|D ]<}t||ƒ}t	 
|¡rÆ| d|¡ t||ƒ q–| d|¡ q–| d¡ tˆ ddƒsøtˆ ddƒ�r| d¡ dS )z+Clean the JupyterLab application directory.zCleaning %s...ÚdevzCannot clean the dev appÚcorezCannot clean the core appÚallFzRemoving everything in %s...)Ú
extensionsÚsettingsr�   rˆ   c                    s   g | ]}t ˆ |ƒr|‘qS rH   )rz   )Ú.0Út©r¿   rH   rI   Ú
<listcomp>Þ  ó    zclean.<locals>.<listcomp>zRemoving %s...z%s not present, skipping...zSuccess!rÎ   zIAll of your extensions have been removed, and will need to be reinstalledN)r¼   r<   r}   Úinfori   r$   r9   rz   Ú_rmtree_starrf   r|   Ú_rmtree)r¿   r<   r}   rG   Zpossible_targetsÚtargetsrÇ   r‹   rH   rÒ   rI   ÚcleanË  s0    


rÙ   Tc           	      C   s0   t |ƒ}t|jƒ t|ƒ}|j| |||||d�S )z!Build the JupyterLab application.)rÇ   ÚversionÚ
static_urlÚ
productionÚminimizeÚclean_staging)r¼   r½   r<   r¾   r‰   )	rÇ   rÚ   rÛ   rF   rÞ   r¿   rÜ   rÝ   rÀ   rH   rH   rI   r‰   í  s    
úr‰   c                 C   s   t | ƒ}| ¡  |jS )z.Get a dictionary of information about the app.)r¾   Ú_ensure_disabled_inforÕ   ©r¿   rÀ   rH   rH   rI   Úget_app_info  s    rá   Ú
sys_prefixc                 C   s   t |ƒ}|j| d|d�S )zgEnable a JupyterLab extension.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    F©Úlevel©r¾   Útoggle_extension©rÄ   r¿   rä   rÀ   rH   rH   rI   Úenable_extension  s    rè   c                 C   s   t |ƒ}|j| d|d�S )zfDisable a JupyterLab package.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    Trã   rå   rç   rH   rH   rI   Údisable_extension  s    ré   c                 C   s   t |ƒ}| | |¡S )z7Check if a JupyterLab extension is enabled or disabled.)r¾   Úcheck_extension)rÄ   Ú	installedr¿   rÀ   rH   rH   rI   rê     s    rê   c                 C   s"   t | ƒ} t| jƒ t| ƒ}| ¡ S )zSDetermine whether JupyterLab should be built.

    Returns a list of messages.
    )r¼   r½   r<   r¾   Úbuild_checkrà   rH   rH   rI   rì   $  s    
rì   c                 C   s   t | ƒ}| ¡ S )zList the extensions.)r¾   Úlist_extensionsrà   rH   rH   rI   rí   /  s    rí   c                 C   s   t |ƒ}| | ¡S )zuLink a package against the JupyterLab build.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    )r¾   Úlink_package)r‚   r¿   rÀ   rH   rH   rI   rî   5  s    rî   c                 C   s   t |ƒ}| | ¡S )zzUnlink a package from JupyterLab by path or name.

    Returns `True` if a rebuild is recommended, `False` otherwise.
    )r¾   Úunlink_package)Úpackager¿   rÀ   rH   rH   rI   rï   >  s    rï   c                 C   s   t | ƒ}|jd S )zGet the application version.rÚ   )r¾   rÕ   rà   rH   rH   rI   Úget_app_versionG  s    rñ   c                 C   s   t |ƒ}| | ¡S )z8Get the latest compatible version of a list of packages.)r¾   Ú"latest_compatible_package_versions)Únamesr¿   rÀ   rH   rH   rI   Ú&get_latest_compatible_package_versionsM  s    rô   c                 C   sL   t  | d¡}| d¡}t | ¡  d¡¡}dd„ | ¡ D ƒ|d< | ¡  |S )z0Read the package data in a given target tarball.Úrzpackage/package.jsonÚutf8c                 S   s   g | ]}|j td ƒd… ‘qS )zpackage/N)r‚   Úlen©rÐ   ÚfrH   rH   rI   rÓ   X  rÔ   z read_package.<locals>.<listcomp>Újupyterlab_extracted_files)	ÚtarfileÚopenÚextractfileÚjsonÚloadsÚreadÚdecodeÚ
getmembersÚclose)r‹   Útarrù   ÚdatarH   rH   rI   Úread_packageS  s    
r  c                   @   sf  e Zd Zdd„ ZdWdd„ZdXdd	„Zd
d„ Zdd„ ZdYdd„Zdd„ Z	dd„ Z
dd„ Zdd„ Zdd„ Zdd„ Zdd„ ZdZdd „Zd[d!d"„Zd#d$„ Zd%d&„ Zd'd(„ Zd)d*„ Zd\d+d,„Zd]d-d.„Zd/d0„ Zd1d2„ Zd3d4„ Zd5d6„ Zd7d8„ Zd9d:„ Zd;d<„ Zd=d>„ Zd?d@„ Z dAdB„ Z!dCdD„ Z"dEdF„ Z#dGdH„ Z$dIdJ„ Z%d^dKdL„Z&d_dMdN„Z'dOdP„ Z(dQdR„ Z)dSdT„ Z*dUdV„ Z+dS )`r¾   c                 C   sn   t |ƒ}|| _|j| _|jr"tƒ n| j| _|j| _t|jj	ƒ| _
|j| _|j| _|j| _|j| _|  ¡ | _dS )zCreate a new _AppHandler objectN)r¼   Ú_optionsr}   r´   r   Úsys_dirr<   r   rœ   Ú_dataÚ	core_datar¶   rF   r¬   r¸   Ú_get_app_inforÕ   )rE   r»   rH   rH   rI   rJ   c  s    z_AppHandler.__init__Nc                 C   s,  t |ƒ}| jd }|| jd v rp|  ¡ }| dg ¡}||v rl| j d| ¡ | |¡ ||d< |  |¡ dS dS |  ¡  tƒ � }| j	|||d�}W d  ƒ n1 s¤0    Y  |d	 }	|d
 rè|  ¡ }| 
di ¡}
|d |
|	< |  |¡ |	|v �r(||	 }|d |d k�r(|d dk�r(t |d ¡ dS )z©Install an extension package into JupyterLab.

        The extension is first validated.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        rÎ   Úcore_extensionsÚuninstalled_core_extensionszInstalling core extension %sTFrÁ   NrÇ   Úis_dirÚlocal_extensionsÚsourcer‚   ÚlocationÚapp)Ú_normalize_pathrÕ   Ú_read_build_configrn   r<   ÚremoveÚ_write_build_configÚ_ensure_app_dirsr   Ú_install_extensionÚ
setdefaultrl   )rE   rÄ   ÚexistingrÂ   rÎ   r±   ÚuninstalledÚtempdirrÕ   rÇ   ÚlocalÚotherrH   rH   rI   rÃ   t  s4    


.

 z_AppHandler.install_extensionFTc                 C   sL  |du r| j d p| j d  }|s&d}| jjrPtt| jd� | jdtdgtd� |rXd	nd
g}|rt| |rndnd¡ | j  dd 	|¡› d�¡ | j
}| j||||d� t|dƒ}	| jdtdg|	d�}
|
dkräd}| j |¡ t|ƒ‚t|	| jƒ d|rúdnd› |�rdnd› �}| jdtd|g|	d�}
|
dk�rHd}| j |¡ t|ƒ‚dS )zBuild the application.NÚlinked_packagesr  F©r<   r€   zbuild:packages©r0   rÜ   ZdevelopmentZ	minimizedznot minimizedzBuilding jupyterlab assets (z, ú))rÇ   rÚ   rÛ   rÙ   r�   Úinstallr   z"npm dependencies failed to installzbuild:ÚprodrË   z	:minimizer.   r“   zJupyterLab failed to build)rÕ   r  r·   r‡   r…   r<   Ú_runr%   r[   r]   r}   Ú_populate_stagingri   r>   ÚRuntimeErrorr„   )rE   rÇ   rÚ   rÛ   rÞ   rÜ   rÝ   rÕ   r}   r�   r†   rG   ÚcommandrH   rH   rI   r‰   ¢  s8    
ÿ
 
z_AppHandler.buildc                 C   s\   t | jdƒ}|  ¡  | jdtdg|d� t|| jƒ tdtddgt | jdƒt| jd�}|gS )zXStart the application watcher and then run the watch in
        the background.
        r�   r€   r#  r!  r“   r”   )r0   r–   r<   )	ri   r}   r&  r%  r%   r„   r<   r   r˜   )rE   r�   rB   rH   rH   rI   r”   Õ  s    

üz_AppHandler.watchc                    sT  |   ¡  | j‰| j}ˆ d|d  ¡ |d s6|d rB|  ¡ |d< |d rR|  ¡  |d r|ˆ d¡ |  |d¡ |  |d¡ |d	 }|rºˆ d
¡ t|ƒD ]}ˆ d|› d|| › �¡ qš|d }|�rˆ d¡ t|ƒD ]&}|| d }ˆ d|› d|› �¡ qÚ|d }|�r0ˆ d¡ ‡fdd„t|ƒD ƒ t|d ƒt|d ƒ t|d ƒ ‰ ‡ fdd„|d D ƒ}|�rªˆ d¡ t|ƒD ]&}	|	ˆ v �r˜|	d7 }	ˆ d|	 ¡ �q‚g }
| jd D ]B}| jd | d }| jd | d }t||dƒ�s¸|
 	|¡ �q¸|
�r"ˆ d¡ ‡fdd„t|
ƒD ƒ | j
dd�}|�rPˆ d¡ ‡fd d„|D ƒ d!S )"z"Print an output of the extensions.zJupyterLab v%srÚ   Úfederated_extensionsrÎ   Úcompat_errorsz+Other labextensions (built into JupyterLab)r  rU   r  z
   local extensions:ú        ú: r  z
   linked packages:r  Úuninstalled_corez
Uninstalled core extensions:c                    s   g | ]}ˆ   d | ¡‘qS ©ú    %s©rÕ   ©rÐ   Úitemr   rH   rI   rÓ     rÔ   z/_AppHandler.list_extensions.<locals>.<listcomp>r  c                    s"   g | ]}|  d ¡d ˆ v r|‘qS )ú:r   )Ú	partition)rÐ   Úi)Úall_extsrH   rI   rÓ     rÔ   Údisabledz
Disabled extensions:z (all plugins)r/  Úshadowed_extsTzO
The following source extensions are overshadowed by older prebuilt extensions:c                    s   g | ]}ˆ   d | ¡‘qS r.  r0  )rÐ   rÇ   r   rH   rI   rÓ   )  rÔ   )Úfastz3
Build recommended, please run `jupyter lab build`:c                    s   g | ]}ˆ   d | ¡‘qS r.  r0  r1  r   rH   rI   rÓ   .  rÔ   N)rß   r<   rÕ   Ú_get_extension_compatÚ_list_federated_extensionsÚ_list_extensionsÚsortedr7   r(   r[   rì   )rE   rÕ   r  rÇ   r  Úkeyr  r-  r7  r2  Zimproper_shadowedZext_nameZsource_versionZprebuilt_versionÚmessagesrH   )r6  r<   rI   rí   é  sn    





ÿ
þÿ

ÿ
z_AppHandler.list_extensionsc                 C   sz  |du r| j }| j}| jd }| jd }g }t|ddƒ}t |¡sHdgS | jd }|d }| d	i ¡}	| d
d¡}
|
 d¡s¦|d
 }t|
ƒt|ƒkr¦d}||
|f gS | jd }| j	|d�}|d }| d	i ¡}dD ]p}|| D ](}||v rîqà||| vrà| 
d| ¡ qà|| D ]0}||v �r$�q||| v�r| 
d| ¡ �qqÔttdƒ}| ¡ D ]v\}}|	 |d¡ |¡�rx�qX||	v�r†�qX||v �sX||v �rž�qX|	| |k�rXd}| 
|||	| || f ¡ �qX| ¡ D ]F\}}|�sØ||v �rô�qØt|dƒ}|  |||¡�rØ| 
d| ¡ �qØ| ¡ D ]L\}}|�s(||v �rD�q(t|ddƒ}|  ||d |¡�r(| 
d| ¡ �q(|S )z[Determine whether JupyterLab should be built.

        Returns a list of messages.
        Nr  r  rˆ   úpackage.jsonzNo built applicationÚstatic_datar£   ÚdependenciesrÚ   r.   ú-splicedz*Version mismatch: %s (built), %s (current)r8  )Úsilent)rÎ   ÚmimeExtensionsz %s needs to be included in buildz!%s needs to be removed from buildr’   z%s changed from %s to %srÎ   z%s content changedr�   r  )r¸   r}   rÕ   ri   rf   r|   rn   Úendswithr   Ú_get_package_templater[   r…   Úitemsr{   Ú_check_local)rE   r9  r}   r  Úlinkedr?  Úpkg_pathrA  Zold_jlabZold_depsZstatic_versionZcore_versionrG   r8  Znew_packageZnew_jlabZnew_depsÚext_typeÚextZsrc_pkg_dirÚpkgÚdeprÇ   r  Údnamer2  rH   rH   rI   rì   0  sr    








 
z_AppHandler.build_checkc                 C   s^  | j }| j}||d v rf|d |  di ¡ dd¡rT| d|d | d d  ¡ n| d| ¡ dS ||d v rÀ|  ¡ }| d	g ¡}||vr¼|  d
| ¡ | |¡ ||d	< |  |¡ dS dS |d }|d  ¡ D ]v\}}|d }	||krÔd|› dt 	|	¡› �}
|  |
¡ t
 |	¡ ||v �rD|  ¡ }| di ¡}||= |  |¡  dS qÔ| d| ¡ dS )zpUninstall an extension by name.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        r)  r#  ZuninstallInstructionsNz.JupyterLab cannot uninstall this extension. %szœJupyterLab cannot uninstall %s since it was installed outside of JupyterLab. Use the same method used to install this extension to uninstall this extension.Fr  r  zUninstalling core extension %sTr  rÎ   r‚   zUninstalling z from ú$No labextension named "%s" installed)rÕ   r<   rn   Úerrorr  r[   r  rH  rf   Údirnamerl   r  r  Úwarning)rE   rÇ   rÕ   r<   r±   r  r  Úextnamer  r‚   rG   rH   rH   rI   rÆ   ƒ  sZ    ÿþÿÿÿÿÿ





z_AppHandler.uninstall_extensionc                 C   s2   d}| j d  ¡ D ]\}}|  |¡}|p*|}q|S )ziUninstalls all extensions

        Returns `True` if a rebuild is recommended, `False` otherwise
        FrÎ   )rÕ   rH  rÆ   )rE   Úshould_rebuildrU  ra   r  rH   rH   rI   rÅ   »  s
    

z$_AppHandler.uninstall_all_extensionsc                 C   sB   d}| j d  ¡ D ]*\}}|| j d v r*q|  |¡}|p:|}q|S )zqUpdate all non-local extensions.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        FrÎ   r  )rÕ   rH  Ú_update_extension)rE   rV  rU  ra   ÚupdatedrH   rH   rI   rÉ   Æ  s    

z!_AppHandler.update_all_extensionsc                 C   s,   || j d vr"| j d| ¡ dS |  |¡S )úmUpdate an extension by name.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        rÎ   rQ  F)rÕ   r<   rT  rW  )rE   rÇ   rH   rH   rI   rÊ   Ô  s    z_AppHandler.update_extensionc                 C   sº   | j d | }|d r*| j d| ¡ dS z|  |¡}W n tyL   Y dS 0 |du rn| j d|› d�¡ dS ||d krŽ| j  d	| ¡ dS | j  d
|› d|› �¡ |  |› d|› �¡S )rY  rÎ   Úalias_package_sourcez(Skipping updating pinned extension '%s'.FNz No compatible version found for ú!rÚ   zExtension %r already up to datez	Updating z to version ú@)rÕ   r<   rT  Ú"_latest_compatible_package_versionr   rÃ   )rE   rÇ   r  ZlatestrH   rH   rI   rW  Þ  s     z_AppHandler._update_extensionc                    sÊ   t |ƒ}t |¡rt |¡s,d}t|| ƒ‚tƒ �}ˆ  ||¡}W d  ƒ n1 sT0    Y  t|d ƒ}|sxˆ  |¡S ˆ j	 
d|¡ ‡ fdd„|D ƒ ˆ  ¡ }| di ¡}|d ||d	 < ˆ  |¡ d
S )zrLink a package at the given path.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        z/Cannot install "%s" only link local directoriesNr  zNInstalling %s as a linked package because it does not have extension metadata:c                    s   g | ]}ˆ j  d | ¡‘qS )z   %s)r<   rT  )rÐ   Úmr§   rH   rI   rÓ   	  rÔ   z,_AppHandler.link_package.<locals>.<listcomp>r  r  rÇ   T)r  rf   r|   Úisdirr9   r   Ú_extract_packageÚ_validate_extensionrÃ   r<   rT  r  r  r  )rE   r‚   rG   r  rÕ   r?  r±   rJ  rH   r§   rI   rî   ô  s$    *
ÿ
z_AppHandler.link_packagec                 C   sÀ   t |ƒ}|  ¡ }| di ¡}d}| ¡ D ]\}}|||fv r(|}q(|rN||= nT| di ¡}| ¡ D ]\}}|||fv rb|}qb|r¢||= | jd | d }t |¡ |s²td| ƒ‚|  |¡ dS )zÉUnlink a package by name or at the given path.

        A ValueError is raised if the path is not an unlinkable package.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        r  Nr  rÎ   r‚   zNo linked package for %sT)	r  r  r  rH  rÕ   rl   r  r9   r  )rE   r‚   r±   rJ  ÚfoundrÇ   r  r  rH   rH   rI   rï     s*    

z_AppHandler.unlink_packagerâ   c           	      C   s€   t  | jd¡}t|| j|d�}| di ¡}d}| |d¡}|rP|sPd||< d}n|sd|rdd||< d}|r|||d< t||d� |S )zsEnable or disable a lab extension.

        Returns `True` if a rebuild is recommended, `False` otherwise.
        rÏ   )Úapp_settings_dirr<   rä   ÚdisabledExtensionsFTrã   )rf   r]   r}   r   r<   rn   r   )	rE   rÄ   Úvaluerä   rc  Úpage_configr7  Zdid_somethingZis_disabledrH   rH   rI   ræ   5  s"    ÿz_AppHandler.toggle_extensionc                 C   s\   |   ¡  | j}||d v r(|  |||¡S ||d v rN| j |› dt› �¡ dS |  |||¡S )z/Check if a lab extension is enabled or disabledr  r  r3  T)rß   rÕ   Ú_check_core_extensionr<   r   Ú_check_common_extension)rE   rÄ   Úcheck_installed_onlyrÕ   rH   rH   rI   rê   O  s    z_AppHandler.check_extensionc                 C   s„   ||d v r&| j  |› dt› �¡ dS |rD| j  |› dt› �¡ dS ||d v rj| j  |› dt› �¡ dS | j  |› dt› �¡ dS )z0Check if a core extension is enabled or disabledr-  r3  Fr,  TÚdisabled_core)r<   rÕ   r   r   r   r   )rE   rÄ   rÕ   ri  rH   rH   rI   rg  ]  s    z!_AppHandler._check_core_extensionc                 C   s²   ||d vr&| j  |› dt› �¡ dS |  ¡ | }|rR| j  |› dt› d�¡ dS |rp| j  |› dt› �¡ dS t||d ƒr˜| j  |› dt› �¡ dS | j  |› dt› �¡ dS )z=Check if a common (non-core) extension is enabled or disabledrÎ   r3  Fz (compatibility errors)r,  Tr7  )r<   rÕ   r   r:  r   Ú_is_disabledr   r   )rE   rÄ   rÕ   ri  ÚerrorsrH   rH   rI   rh  k  s    z#_AppHandler._check_common_extensionc                    s0  i ‰ | j  ˆ d< }|  |¡ ˆ d< }|  ¡ ˆ d< |  ¡ ˆ d< g  ˆ d< }g  ˆ d< }| ¡ D ]:\}}|ˆ d v |d< |d d	krŒ| |¡ q\| |¡ q\|  ¡ ˆ d
< t| jƒˆ d< ˆ d p¼|}|d d ˆ d< |d  	dd¡ˆ d< | j
ˆ d< | jˆ d< t| j ƒˆ d< t| jƒˆ d< ‡ fdd„ˆ d D ƒˆ d< ˆ S )zGet information about the app.r
  rÎ   r  r  Zapp_extensionsZsys_extensionsÚis_localr  r  r-  rA  r£   rÚ   Ú	staticUrlr.   r  r}   r  r)  c                    s   g | ]}|ˆ d  v r|‘qS )r)  rH   )rÐ   rM  r0  rH   rI   rÓ      s   z-_AppHandler._get_app_info.<locals>.<listcomp>r8  )r
  Ú_get_extensionsÚ_get_local_extensionsÚ_get_linked_packagesrH  r[   Ú _get_uninstalled_core_extensionsÚ_get_static_datar}   rn   r  Ú_get_core_extensionsr   r¶   )rE   r
  rÎ   r  rU   rÇ   r  Zapp_datarH   r0  rI   r  �  s2    


ÿ
z_AppHandler._get_app_infoc                 C   s–   | j }d|v rd S | j}t | jd¡}t||| jd�}| di ¡}t|t	ƒrZdd„ |D ƒ}||d< g }|d D ]}||d v rn| 
|¡ qn||d< d S )	Nr7  rÏ   )rc  r<   rd  c                 S   s   i | ]
}|d “qS )TrH   )rÐ   rÄ   rH   rH   rI   Ú
<dictcomp>µ  rÔ   z5_AppHandler._ensure_disabled_info.<locals>.<dictcomp>r  rj  )rÕ   r¶   rf   r]   r}   r   r<   rn   r6   r7   r[   )rE   rÕ   r¶   rc  rf  r7  rj  r>  rH   rH   rI   rß   ¥  s"    ÿ
z!_AppHandler._ensure_disabled_infoc           !   
   C   sv  | j }t|dƒ}|r8t |¡r8| j d|¡ t|| jƒ |  ¡  |sV| jd d d }| jj	}|r|| j 
d¡ t}td }n
ttdƒ}t|dƒ}	t |	¡röt|	ƒ�}
t |
¡}W d	  ƒ n1 sÂ0    Y  |d  dd
¡|kröt|| jƒ t |¡ dD ] }t||ƒ}t t||ƒ|¡ qúdD ]$}t||ƒ}t ttd|ƒ|¡ �q t|dƒ}t |¡�rht|| jƒ zt t|dƒ|¡ W nV tj�yÔ } z:dt|ƒv�oªdt|ƒv}|�s¾t |¡�sÀ‚ W Y d	}~n
d	}~0 0 t|dƒ}t |¡�røt|| jƒ t |¡ | jd }d}| jd  ¡ D ]`\}}||v�r\|  ¡ }| di ¡}||= |  |¡ d}�qt|dƒ}|  ||||| d¡ �q|�r”|  ¡ | jd< | jd }| ¡ D ]*\}}t|dƒ}|  ||d ||d¡ �q¦|  ¡ }|d }|�rð||d< |�rþ||d< |�r||d< |�rêt tt!dddƒƒD ]t}t "t #|¡¡}t $t%|ƒj&dd�¡}|d }||d v �r|||d |< ||d |< ||d v �r$||d |< �q$t #tt!dƒ¡}||d  d!< t '|d"d#d¡}t|d"ƒ}t |¡�rêtj(|dd$� t|dƒ}	t|	d%ƒ� }
tj)||
d&d'� W d	  ƒ n1 �s&0    Y  t|d(ƒ}ttdd(ƒ} t |¡�srt | |¡ t *|t+j,t+j-B ¡ d	S ))z+Set up the assets in the staging directory.r�   zCleaning %sr
  r£   rÚ   z)Splicing dev packages into app directory.rC  r@  Nr.   )úindex.jszbootstrap.jszpublicpath.jszwebpack.config.jszwebpack.prod.config.jszwebpack.prod.minimize.config.js)z.yarnrc.ymlzyarn.jsÚ	templatesz
[Errno 22]z	[Errno 5]r  rÎ   Fr  Tr  rÇ   rn  r’   Ú*r/   )r5   rB  ÚlinkedPackagesÚresolutionsÚbuilderZdevDependenciesz@jupyterlab/builderÚnode_modulesz@jupyterlab)Úignore_errorsÚwé   ©Úindentz	yarn.lock).r}   ri   rf   r|   r<   rÕ   r×   r  r  r·   r>   rŠ   r!   r$   rü   rþ   Úloadrn   rl   ÚmakedirsÚshutilÚcopyÚcopytreeÚErrorru   rH  r  r  r  Ú_update_localrp  rG  r   r…   rS  rg   rÿ   r   Ú	read_textr]   ÚrmtreeÚdumpÚchmodÚstatÚS_IWRITEÚS_IREAD)!rE   rÇ   rÚ   rÛ   rÙ   r}   r�   r·   Ú
source_dirrK  Úfidr  Úfnamer‹   rw  rR  Z
real_errorZ
linked_dirrÎ   Úremovedr>  r  r±   rP  rJ  r2  Újlabr‚   Z
local_pathZpkg_datar|  Z	lock_pathZlock_templaterH   rH   rI   r&  À  s´    





(













0
z_AppHandler._populate_stagingc                    s8  ˆ j }tˆ jd ƒ}ˆ jd }ˆ jd }ˆ jd }ˆ jd }|d }‡ fdd„}	i |d	< | ¡ D ]<\}
}|
|v rrq`||d	 |
< d
ˆ jd |
 d  |d |
< q`| ¡ D ]^\}
}|
|v r¸q¦tˆ jddƒ}t||d ƒ}|	|ƒ|d |
< |d |d	 |
< |	|ƒ|d |
< q¦i |d d< ˆ  ¡ }| ¡ D ] \}
}||
 }|�rT|�s"t||
|d |ƒ �q"|	|d ƒ|d |
< |d }dD ]J}| |d¡}|�sŽ�qt|du �rœd}|||d  |
< ||d d |
< �qt�q"ˆ jd D ]d}||d v �rô|d d  	|¡ n ||d v �r|d d  	|¡ ||d v �rÎ|d  	|¡ �qÎ|S )z3Get the template the for staging package.json file.r
  r  r  rÎ   r8  r£   c              
      sH   t  | t  t  tˆ jdƒ¡¡¡} d|  tjd¡ } tj	dkrD|  
¡ } | S )Nr�   úfile:rN   Únt)rf   Úrelpathrg   Úrealpathri   r}   Úreplacerl   ÚseprÇ   Úlower)r‚   r§   rH   rI   Úformat_pathX  s
     
z6_AppHandler._get_package_template.<locals>.format_pathry  r•  r‚   rz  r�   ÚfilenamerB  r  ZextensionMetadatarÚ   )rÄ   ÚmimeExtensionFTr.   Úsr-  rE  )
r<   r   rÕ   rH  ri   r}   r:  Ú_log_single_compat_errorsrn   r�   )rE   rD  r<   r  r  rJ  rÎ   r8  r”  rœ  r>  r  r2  r‚   r*  re  rl  Z	jlab_datarM  rH   r§   rI   rG  M  s`    



 
z!_AppHandler._get_package_templatec                 C   sP   t ƒ �6}|  ||¡}t||d ƒ}t |¡ W  d  ƒ S 1 sB0    Y  dS )zwCheck if a local package has changed.

        `dname` is the directory name of existing package tar archives.
        r�  N)r   r`  ri   rf   r|   )rE   rÇ   r  rP  r  rÕ   r‹   rH   rH   rI   rI  ˜  s    z_AppHandler._check_localc           	      C   sÄ   |d }t  t||ƒ¡sd}tƒ �T}|  ||¡}|d |krN|W  d  ƒ S t |d t||d ƒ¡ W d  ƒ n1 s|0    Y  |ršt t||ƒ¡ |d |d< t|d |d ƒ|d< |d S )z5Update a local dependency.  Return `True` if changed.r�  r.   Nr‚   Útar_dir)	rf   r|   ri   r   r`  r„  Úmoverl   r  )	rE   rÇ   r  rP  r  Zdtyper  r  rÕ   rH   rH   rI   rˆ  §  s    8z_AppHandler._update_localc                 C   sf   | j }i }t| jdƒ}t| j dƒ}|  | j|¡}t|dƒ}||ksLt |¡sP|S | |  ||¡¡ |S )z'Get the extensions for the application.rÎ   )r}   ri   r  Ú_get_extensions_in_dirrf   r|   Úupdate)rE   r
  r}   rÎ   Úsys_pathZapp_pathrH   rH   rI   ro  ¿  s    
z_AppHandler._get_extensionsc                 C   sÜ   i }|| j krdnd}tt|ddƒƒD ]°}t|ƒ}| di ¡}|d }| di ¡}	t |¡}
t |¡}| t	¡rˆ|t
t	ƒt
dƒ … }nd	}t|ƒ}| d
d¡|
t |
¡||d |r¸|nd	|	|t |
¡|dœ
||pÔ|< q&|S )z(Get the extensions in a given directory.r  rU   rÎ   ú*.tgzrB  rÇ   r£   ú.tgzNÚdescriptionr.   rÚ   )
r¨  r‚   r�  ÚurlrÚ   rZ  r£   rB  r¡  r  )r}   r   ri   r  rn   rf   rg   Úbasenamer{   Ú
PIN_PREFIXr÷   r   rS  )rE   rP  r
  rÎ   r  r‹   r  ÚdepsrÇ   r”  r‚   r�  Úaliasr©  rH   rH   rI   r£  Ó  s2    




õz"_AppHandler._get_extensions_in_dirc                 C   sŒ   i }| j d }tƒ }| j d  ¡ D ]*\}}|d }t|||ƒ||< | |¡ q"| j d  ¡ D ]*\}}||v rnq\|d }t|||ƒ||< q\|S )z%Get the extension compatibility info.r
  r)  rB  rÎ   )rÕ   ÚsetrH  Ú_validate_compatibilityrD   )rE   Úcompatr
  ÚseenrÇ   r  r¬  rH   rH   rI   r:  ó  s    
z!_AppHandler._get_extension_compatc                 C   s
   |   d¡S )z%Get the locally installed extensions.r  )Ú_get_local_datar§   rH   rH   rI   rp    s    z!_AppHandler._get_local_extensionsc                 C   sÐ   |   d¡}t| jddƒ}| ¡ D ]\}}|d|dœ||< q t |¡sH|S tt|dƒƒD ]t}t |¡}t|ƒ}|d }||vr˜| j	 
d| ¡ t |¡ qV|| }t |¡|d< ||d	< |d
 |d
< ||d< qV|S )zGet the linked packages.r  r�   r.   )r  r�  r¡  r¦  rÇ   z#Removing orphaned linked package %sr�  r‚   rÚ   r  )r²  ri   r}   rH  rf   r|   r   rg   r  r<   rT  rl   r  rª  )rE   rÕ   rP  rÇ   r  r‚   r  r2  rH   rH   rI   rq    s(    




z _AppHandler._get_linked_packagesc                 C   s   |   ¡ }| dg ¡S )z$Get the uninstalled core extensions.r  )r  rn   r°   rH   rH   rI   rr     s    z,_AppHandler._get_uninstalled_core_extensionsc                 C   sn   g d¢}|D ]\}t | j|ƒ}t |¡szt |¡ W q tyf } z|jtjkrR‚ W Y d}~qd}~0 0 qdS )z-Ensure that the application directories exist)rÎ   rÏ   r�   ZschemasÚthemesN)	ri   r}   rf   r|   rl   rƒ  ÚOSErrorÚerrnoÚEEXIST)rE   ÚdirsrP  r‚   ÚerH   rH   rI   r  %  s    
z_AppHandler._ensure_app_dirsc              
   C   sP  |   ¡  | j}|d|  }|s"dS |d|  }i }| d|› d|› �¡ t|ƒD ]æ}||d v rbqP|d | }|d }	|d	 | }
d
}t||d ƒr¢|dt 7 }n|dt 7 }|
rÀ|dt 7 }n|dt 7 }|d rÜ|d7 }|d }|�r| d|› d|› d|	› |› �¡ n| d|› d|	› |› �¡ |
rP|	|
f||< qPt	||ƒ | d
¡ dS )z$List the extensions of a given type.z%s_extensionsNz%s_dirz   z dir: r)  rÎ   rÚ   r*  r.   r7  ú %srm  rx  rZ  r+  ú ú v)
rß   r<   rÕ   r=  rk  r   r   r   r   Ú_log_multiple_compat_errors)rE   rÕ   rL  r<   ró   rP  Úerror_accumulatorrÇ   r  rÚ   rl  ÚextrarZ  rH   rH   rI   r<  1  s>    "
z_AppHandler._list_extensionsc              	   C   sj  |   ¡  | j}| j}i }dd„ | jD ƒ}|d  ¡ D ]}d||d < q4| ¡ D �]
\}}|s^qN| |¡ |d D ]Þ}|d | }	|	d |krŽqp|	d }
|d | }d}t||d	 ƒrÂ|d
t 7 }n|d
t 7 }|rà|d
t	 7 }n|d
t
 7 }|	d rü|d7 }|	 d¡}|�r$|d |d |d ¡7 }| d|› d|
› |› �¡ |rp|
|f||< qp| d¡ qNt||ƒ d S )Nc                 S   s   i | ]
}|d “qS )FrH   )rÐ   ÚprH   rH   rI   ru  e  rÔ   z:_AppHandler._list_federated_extensions.<locals>.<dictcomp>r)  TÚext_dirrÚ   r*  r.   r7  r¹  rm  rx  r#  z	 ({}, {})ZpackageManagerÚpackageNamer+  r»  )rß   rÕ   r<   r¶   ÚvaluesrH  rk  r   r   r   r   rn   Úformatr¼  )rE   rÕ   r<   r½  Zext_dirsre  rÀ  Zhas_extsrÇ   r  rÚ   rl  r¾  r#  rH   rH   rI   r;  ^  sD    

z&_AppHandler._list_federated_extensionsc                 C   sR   t | jddƒ}t |¡si S t|ƒ�}t |¡W  d  ƒ S 1 sD0    Y  dS )z*Get the build config data for the app dir.rÏ   úbuild_config.jsonN)ri   r}   rf   r|   rü   rþ   r‚  )rE   r‹   r‘  rH   rH   rI   r  ‹  s
    

z_AppHandler._read_build_configc                 C   sT   |   ¡  t| jddƒ}t|dƒ� }tj||dd� W d  ƒ n1 sF0    Y  dS )z&Write the build config to the app dir.rÏ   rÄ  r~  r  r€  N)r  ri   r}   rü   rþ   r‹  )rE   r±   r‹   r‘  rH   rH   rI   r  ”  s    z_AppHandler._write_build_configc                 C   sŠ   |   ¡ }| |i ¡}g }| ¡ D ]\}}t |¡s | |¡ q |D ]4}| dd¡}d|› d|› d�}| j |¡ ||= qB|r†|  	|¡ |S )z5Get the local data for extensions or linked packages.ra   rº  z**Note: Removing dead z "ú")
r  r  rH  rf   r|   r[   r™  r<   rT  r  )rE   r  r±   r  ZdeadrÇ   Z	link_typerG   rH   rH   rI   r²  ›  s    

z_AppHandler._get_local_datac                 C   sÚ  | j |||d�}|d }d|dd… vo0|d  }|d }t|ƒ}|r–d}	|	|d	 |¡f }	|rŽz|  |¡}
W q– tyŠ   t|	ƒd‚Y q–0 nt|	ƒ‚| d
i ¡}t||| jƒ}|�r–t	|d |d |ƒ}	|�rŽz|  |¡}
W n tyú   t|	ƒd‚Y n0 |
�rb|�rb| j
 d|¡ | j
 d|
¡ tƒ �&}|  |› d|
› �|¡W  d  ƒ S 1 �sX0    Y  d	 |	 ¡ dd… ¡}d |  |¡d|f¡}	t|	ƒ‚t| jd|d ƒ}t |¡�r¾t |¡ t |d |¡ ||d< |S )zBInstall an extension with validation and return the name and path.rÁ   r  r\  é   Nr  rÇ   z!"%s" is not a valid extension:
%srQ   rB  rÚ   zIncompatible extension:
%szFound compatible version: %sé   r.   z

rÎ   r�  r‚   )r`  ra  r]   r]  r   r9   rn   r¯  r
  Ú_format_compatibility_errorsr<   r>   r   r  Ú
splitlinesÚ%_format_no_compatible_package_versionri   r}   rf   r|   rl   r  r„  r¢  )rE   rÄ   r  rÂ   rÕ   r  Zallow_fallbackrÇ   r?  rG   rÚ   r¬  rl  Ztempdir2Ú	conflictsr‹   rH   rH   rI   r  °  sJ    6
z_AppHandler._install_extensionc                 C   sH  t  |¡ot  |¡}|r<t  t|dƒ¡s<| jdtdg|d� ||dœ}| jtdƒd|g|d�}|dkrvd	}t|| ƒ‚tt|d
ƒƒd }t	|ƒ|d< |rÎt
|ƒ |d< }	| dd|	 ¡}
t ||
¡ |
|d< n||d< |�r|d }tt  |¡t› |› d�ƒ}t ||¡ ||d< t  |d ¡|d< |d d |d< |d d |d< |S )zÇCall `npm pack` for an extension.

        The pack command will download the package tar if `source` is
        a package name, or run `npm pack` locally if `source` is a
        directory.
        r|  r€   r#  r!  )r  r  ÚnpmÚpackr   ú"%s" is not a valid npm packager¦  r  Úshar§  z-%s.tgzr‚   r�  rÇ   rÚ   )rf   r|   r_  ri   r%  r%   r   r9   r   r  Ú_tarsumr™  r„  r¢  rS  r«  rª  )rE   r  r  rÂ   r  rÕ   r†   rG   r‚   rÏ  r‹   Úold_pathÚnew_pathrH   rH   rI   r`  ë  s2    

z_AppHandler._extract_packagec              	   C   sü   | j d }zt| j|| jƒ}W n ty2   Y dS 0 | di ¡}dd„ }t| ¡ |dd�D ]œ\}}| di ¡}t|||ƒ}	|	sZd	|v r | j 	d
|› d|› �¡ qZt
ƒ �&}
|  |› d|› �|
¡}W d  ƒ n1 sÒ0    Y  t|d ƒrî dS |  S qZdS )ú.Get the latest compatible version of a packager
  NÚversionsc                 S   s   t | d dd�S ©Nr   T)Úprerelease_first©Ú_semver_key©Ú	key_valuerH   rH   rI   Úsort_key  s    z@_AppHandler._latest_compatible_package_version.<locals>.sort_keyT©r>  ÚreverserB  Ú
deprecatedz@Disregarding compatible version of package as it is deprecated: r\  r  )rÕ   Ú_fetch_package_metadatar¬   r<   r   rn   r=  rH  r¯  r>   r   r`  ra  )rE   rÇ   r
  ÚmetadatarÔ  rÛ  rÚ   r  r¬  rl  r  rÕ   rH   rH   rI   r]    s*    
ÿ4z._AppHandler._latest_compatible_package_versionc              	   C   s~  | j d }g }|D ]ž}zt| j|| jƒ}W n ty@   Y qY n0 | di ¡}dd„ }t| ¡ |dd�D ]F\}}	d|	v rzqh|	 di ¡}
t||
|ƒ}|sh| 	|› d	|› �¡  qqhqi }|s¾|S t
ƒ �¤}| jtd
ƒdg|¢|d�}|dkrød}t|| ƒ‚|D ]\}|d  d	d¡|dd…  d	d¡ dd¡ d }tt ||¡ƒ}	t|	ƒsü|	d ||	d < qüW d  ƒ n1 �sp0    Y  |S )zÉGet the latest compatible versions of several packages

        Like _latest_compatible_package_version, but optimized for
        retrieving the latest version for several packages in one go.
        r
  rÔ  c                 S   s   t | d dd�S rÕ  r×  rÙ  rH   rH   rI   rÛ  D  s    z@_AppHandler.latest_compatible_package_versions.<locals>.sort_keyTrÜ  rÞ  rB  r\  rÌ  rÍ  r!  r   rÎ  r.   rÆ  NrK   rN   r§  rÚ   rÇ   )rÕ   rß  r¬   r<   r   rn   r=  rH  r¯  r[   r   r%  r   r9   r™  r  rf   r]   ra  )rE   ró   r
  ÚkeysrÇ   rà  rÔ  rÛ  rÚ   r  r¬  rl  r  r†   rG   r>  r’  rH   rH   rI   rò   3  s@    

.ÿ2z._AppHandler.latest_compatible_package_versionsc                 C   s  | j d }d}d}zt| j|| jƒ}W n ty8   Y n˜0 | di ¡}dd„ }tt| ¡ |dd�ƒ}|d d	  d
i ¡}	|d }
|d d }|	 ¡ D ]:\}}||v r”t	|
| |dd�}|pÀ|dk }|pÌ|dk}q”|rÜd| S dg}|rð| 
d¡ d |¡j|d�S )rÓ  r
  FrÔ  c                 S   s   t | d dd�S rÕ  r×  rÙ  rH   rH   rI   rÛ  w  s    zC_AppHandler._format_no_compatible_package_version.<locals>.sort_keyTrÜ  r   rÆ  rB  rz  r£   ÚsingletonPackages©Údrop_prerelease1zKThe extension "%s" does not yet support the current version of JupyterLab.
zcNo version of {extension} could be found that is compatible with the current version of JupyterLab.)z9However, it seems to support a new version of JupyterLab.zConsider upgrading JupyterLab.rº  ©rÄ   )rÕ   rß  r¬   r<   r   rn   r8   r=  rH  Ú_compare_rangesÚextendr]   rÃ  )rE   rÇ   r
  Zlab_newer_than_latestZlatest_newer_than_labrà  rÔ  rÛ  ÚstoreZlatest_depsÚ	core_depsÚ
singletonsr>  re  ÚcÚpartsrH   rH   rI   rÊ  g  s<    
ÿÿÿÿz1_AppHandler._format_no_compatible_package_versionc                 K   sB   | j  ¡ rd}t|ƒ‚| j|d< | j |d< t|fi |¤Ž}| ¡ S )z]Run the command using our logger and abort callback.

        Returns the exit code.
        zCommand was killedr<   rF   )rF   r:   r9   r<   r-   rb   )rE   r=   rŸ   rG   rB   rH   rH   rI   r%  ž  s    


z_AppHandler._run)NN)NNNFTT)N)râ   )F)NNNF)F)N)N),rc   rd   re   rJ   rÃ   r‰   r”   rí   rì   rÆ   rÅ   rÉ   rÊ   rW  rî   rï   ræ   rê   rg  rh  r  rß   r&  rG  rI  rˆ  ro  r£  r:  rp  rq  rr  r  r<  r;  r  r  r²  r  r`  r]  rò   rÊ  r%  rH   rH   rH   rI   r¾   b  s`   
0      ù
3G
S8
"

$
 
K --	
;
'!47r¾   c                 C   sl   t dƒ}z&tj|dgtd�}|  | d¡¡ W n8 tyf   tƒ j}|d d }d| }t	|ƒd‚Y n0 dS )z;Check for the existence of nodejs with the correct version.r€   znode-version-check.jsr!  r/   ZenginesztPlease install nodejs %s before continuing. nodejs may be installed using conda or directly from the nodejs website.N)
r   r?   Úcheck_outputr$   r>   r  Ú	Exceptionr#   r	  r9   )r<   r€   Úoutputr  ÚverrG   rH   rH   rI   r½   ­  s    ÿÿr½   c                 C   s`  i i dœ}zt dƒ}W n  ty6   |  d¡ | Y S 0 z¤tj|tddgtjtd�}| d¡}t	| 
¡ ƒ}zR|D ]H}t |¡}|d d	krp|d
 }t t|ƒ¡}	|	d dkrp|	d
 ||< qpW n tyÎ   Y n0 |  d¡ W n~ tj�y& }
 z.|  d |
j d¡|
j d¡¡¡ W Y d}
~
n>d}
~
0  t�yZ }
 z|  d|
›�¡ W Y d}
~
n
d}
~
0 0 |S )z”Get the yarn configuration.

    Returns
    -------
    {"yarn config": dict, "npm config": dict} if unsuccessfull the subdictionary are empty
    )r­   z
npm configr€   z9NodeJS was not found. Yarn user configuration is ignored.r±   z--json)r2   r0   r/   ÚtyperÕ   r  ÚinspectzYarn configuration loaded.z(Fail to get yarn configuration. {!s}{!s}Nz Fail to get yarn configuration. )r   r9   r>   r?   rí  r%   rA   r$   r  ÚiterrÉ  rþ   rÿ   rW   ÚStopIterationÚCalledProcessErrorrR  rÃ  r2   rï  rî  )r<   Úconfigurationr€   Zoutput_binaryrï  ÚlinesÚlinerÕ   r>  rò  r¸  rH   rH   rI   r®   ½  s@    


ÿ

ÿÿ&r®   c                 C   s   | pt  d¡S )zEnsure that we have a loggerr£   r¤   r   rH   rH   rI   r;   è  s    r;   c                 C   s"   t  | ¡} t  | ¡rt  | ¡} | S )z,Normalize a given extension if it is a path.)rf   Ú
expanduserr|   rg   rå  rH   rH   rI   r  í  s    


r  c                    s   ‡ fdd„}t j| |d� dS )zRemove a tree, logging errorsc                     s   ˆ j d| d� d S )NzError in shutil.rmtree©Úexc_info)r>   rú  r   rH   rI   Úonerrorø  s    z_rmtree.<locals>.onerror)rü  N)r„  rŠ  )r‚   r<   rü  rH   r   rI   r×   õ  s    r×   c                 C   s8   zt  | ¡ W n$ ty2   |jdt ¡ d� Y n0 dS )zRemove a file, logging errorszError in os.unlinkrú  N)rl   Úunlinkrî  r>   rU   rû  )r‚   r<   rH   rH   rI   Ú_unlinkþ  s    rþ  c                 C   sT   t  | ¡D ]D}t | |¡}t |¡s.t |¡r:t||ƒ q
t |¡r
t||ƒ q
dS )z3Remove all files/trees within a dir, logging errorsN)	rl   Úlistdirrf   r]   ÚisfileÚislinkrþ  r_  r×   )r‚   r<   r�  Ú	file_pathrH   rH   rI   rÖ     s    
rÖ   c                    sŒ  |   dd¡}|du rdgS t|tƒs*dgS |  dd¡}|  dd¡}|  dd	¡‰|  d
d	¡‰ g }|sp|sp| d¡ ||kr†d}| |¡ | d }|   dd¡}| d¡s¬|d7 }|du rº|}n|rÐ| d¡sÐ|d7 }|du rÞ|}n|rô| d¡sô|d7 }|�r||v�r| d| ¡ |�r0||v�r0| d| ¡ ˆ�r\t‡fdd„|D ƒƒ�s\| dˆ ¡ ˆ �rˆt‡ fdd„|D ƒƒ�sˆ| dˆ  ¡ |S )z`Detect if a package is an extension using its metadata.

    Returns any problems it finds.
    r£   NzNo `jupyterlab` keyz*The `jupyterlab` key must be a JSON objectrÄ   Frž  Z	themePathr.   Z	schemaDirz-No `extension` or `mimeExtension` key presentz?`mimeExtension` and `extension` must point to different modulesrú   Úmainrv  z.jsTzMissing extension module "%s"z!Missing mimeExtension module "%s"c                 3   s    | ]}|  ttˆ ƒƒ¡V  qd S r©   ©r{   ru   r   rø   )Ú
theme_pathrH   rI   Ú	<genexpr><  rÔ   z&_validate_extension.<locals>.<genexpr>zthemePath is empty: "%s"c                 3   s    | ]}|  ttˆ ƒƒ¡V  qd S r©   r  rø   )Ú
schema_dirrH   rI   r  ?  rÔ   zschemaDir is empty: "%s")rn   r6   Údictr[   rF  Úany)r  r”  rÄ   Zmime_extensionr?  rG   Úfilesr  rH   )r  r  rI   ra    sH    



ra  c                 C   sd   t  | d¡}d}t d¡}|D ]<}| ¡ s,q| |¡}| |¡}|r| |¡ | |¡}q@q| ¡ S )z6
    Compute the recursive sha sum of a tar file.
    rõ   i � Úsha1)	rû   rü   ÚhashlibÚnewr   rý   r   r¤  Ú	hexdigest)Z
input_filer  Ú
chunk_sizeÚhÚmemberrù   r  rH   rH   rI   rÐ  E  s    



rÐ  c                 C   sR   t | ddƒ}t |¡rJt|ƒ�}t |¡W  d  ƒ S 1 s>0    Y  ndS dS )z$Get the data for the app static dir.rˆ   r@  N)ri   rf   r|   rü   rþ   r‚  )r}   r‹   r‘  rH   rH   rI   rs  X  s
    

*rs  c           	      C   sd   |d }|d d }g }|  ¡ D ]>\}}||v r t|| |dd�}|du r | ||| |f¡ q |S )z+Validate the compatibility of an extension.rz  r£   râ  Trã  F)rH  Ú_test_overlapr[   )	rÄ   r¬  r
  ré  rê  rl  r>  re  ÚoverlaprH   rH   rI   r¯  b  s    r¯  c                 C   s$   t | |||d�}|du rdS |dkS )z�Test whether two version specs overlap.

    Returns `None` if we cannot determine compatibility,
    otherwise whether there is an overlap
    )rä  Údrop_prerelease2Nr   ©ræ  )Úspec1Úspec2rä  r  ÚcmprH   rH   rI   r  u  s    ÿr  c                 C   s&  t | dƒ}t |dƒ}|jr |js$dS d}t |j|j¡D �]Ø\}}|d j}	|d j}
|d j}|d j}|	jr~|r~|	 d¡}	|jr’|r’| d¡}|d j}|d j}| 	d¡s8| 	d¡r¼q8|	|
krÈt
nt}||krØt
nt}|	|
krètnt}|	|
krøtnt}dd	„ }|	|
k�r| 	d
¡�r|}||k�r8| 	d
¡�r8|}t|	|dƒ�rT||	|dƒ�s¨||
|dƒ�rp||
|dƒ�s¨t||	dƒ�rŒ|||
dƒ�s¨|||	dƒ�r®|||
dƒ�r® dS t||
dƒ�rÚ|du �rÌd}q8|dkr8d}q8t|	|dƒ�r|du �rød}q8|dkr8d}q8d}t|ƒ‚q8|du �r"d}|S )zïTest whether two version specs overlap.

    Returns `None` if we cannot determine compatibility,
    otherwise return 0 if there is an overlap, 1 if
    spec1 is lower/older than spec2, and -1 if spec1
    is higher/newer than spec2.
    TNFr   éÿÿÿÿÚpatchú<c                 S   s   dS )NTrH   )ÚxÚyÚzrH   rH   rI   Únoop±  s    z_compare_ranges.<locals>.noopú>rÆ  z(Unexpected case comparing version ranges)r&   ÚrangerR   Úproductr®  ZsemverÚ
prereleaseÚincÚoperatorr{   r*   r)   r(   r'   ÚAssertionError)r  r  rä  r  Úr1Úr2Zreturn_valueZr1setZr2setÚx1Zx2Úy1Úy2Zo1Úo2ÚlxZlyZgxÚgyr  rG   rH   rH   rI   ræ  ƒ  sz    	












ÿ
þ
ý
ü
û
ú
ù
ø



ræ  c                 C   sP   |pi }|  ¡ D ]:\}}|du r"q| |kr0 dS t |¡ | ¡dur dS qdS )z%Test whether the package is disabled.FTN)rH  ÚreÚcompileÚmatch)rÇ   r7  Úpatternre  rH   rH   rI   rk  à  s    rk  c                 C   sà   g }d}d}|D ]^}|\}}}	t t|dƒƒ}t t|	dƒƒ}	| |||	f¡ t|t|ƒd ƒ}t|t|ƒd ƒ}qd}
|
| |f }
|
d7 }
|
d |¡7 }
|
d |¡7 }
|
d7 }
|D ]*\}}}	|
| |¡|	 |¡ | d	 7 }
q°|
S )
z*Format a message for compatibility errors.é
   TrÆ  z6
"%s@%s" is not compatible with the current JupyterLabz
Conflicting Dependencies:
Z
JupyterLabÚ	ExtensionzPackage
rQ   )ru   r&   r[   Úmaxr÷   Úljust)rÇ   rÚ   rl  r�   Zl0Úl1rR  rN  r”  rM  rG   rH   rH   rI   rÈ  î  s&    
"rÈ  c           
      C   s˜   g }g }|  ¡ D ]2\}\}}t|ƒ}|dkr8| |¡ q| |¡ q|rb|  d dg|¢d‘¡¡ |D ],}|| \}}t|||ƒ}	|  |	› d�¡ qfdS )z8Log compatibility errors for multiple extensions at oncer   z	
        z*
   The following extensions are outdated:zD
   Consider checking if an update is available for these packages.
rQ   N)rH  Ú_compat_error_ager[   rT  r]   rÈ  )
r<   Z
errors_mapZoutdatedÚothersrÇ   ra   rl  ÚagerÚ   rG   rH   rH   rI   r¼  	  s,    ÿþýÿÿ
r¼  c                 C   s>   t |ƒ}|dkr|  d|¡ nt|||ƒ}|  |› d�¡ dS )z/Log compatability errors for a single extensionr   z The extension "%s" is outdated.
rQ   N)r8  rT  rÈ  )r<   rÇ   rÚ   rl  r:  rG   rH   rH   rI   r   &	  s
    r   c                 C   sZ   d}d}| D ]0\}}}t ||dd�}|p.|dk }|p:|dk}q|rJ|sJdS |rV|sVdS dS )zýCompare all incompatibilities for an extension.

    Returns a number > 0 if all extensions are older than that supported by lab.
    Returns a number < 0 if all extensions are newer than that supported by lab.
    Returns 0 otherwise (i.e. a mix).
    FTrã  r   rÆ  r  r  )rl  Z	any_olderZ	any_newerra   r”  rM  rë  rH   rH   rI   r8  1	  s    r8  c                 C   s    | d }t |d ƒt |d ƒ S )zGet the core extensions.r£   rÎ   rE  )r7   )r
  r  rH   rH   rI   rt  K	  s    rt  c                 c   s,   | D ]"}t |tƒrd|fV  q|fV  qdS )az  Sort key for prereleases.

    Precedence for two pre-release versions with the same
    major, minor, and patch version MUST be determined by
    comparing each dot separated identifier from left to
    right until a difference is found as follows:
    identifiers consisting of only digits are compare
    numerically and identifiers with letters or hyphens
    are compared lexically in ASCII sort order. Numeric
    identifiers always have lower precedence than non-
    numeric identifiers. A larger set of pre-release
    fields has a higher precedence than a smaller set,
    if all of the preceding identifiers are equal.
    r.   N)r6   Úint)r#  ÚentryrH   rH   rI   Ú_semver_prerelease_keyQ	  s    
r=  c                 C   st   t | dƒ}|r|jrdqdnd}g |¢|j‘|j‘|j‘R }|sX|jrTg |¢d‘R nd}|jrp|tt|jƒƒ }|S )aË  A sort key-function for sorting semver version string.

    The default sorting order is ascending (0.x -> 1.x -> 2.x).

    If `prerelease_first`, pre-releases will come before
    ALL other semver keys (not just those with same version).
    I.e (1.0-pre, 2.0-pre -> 0.x -> 1.x -> 2.x).

    Otherwise it will sort in the standard way that it simply
    comes before any release with shared version string
    (0.x -> 1.0-pre -> 1.x -> 2.0-pre -> 2.x).
    T)r   )rÆ  rH   r   )r+   r#  ÚmajorÚminorr  r8   r=  )rÚ   rÖ  Úvr>  rH   rH   rI   rØ  i	  s    
rØ  c              
   C   sÚ   t t| t|dd�ƒddid�}z| d|j ¡ W n$ tyV   | d| ¡  ¡ Y n0 zHt t	|ƒ¡�&}t
 | ¡  d¡¡W  d  ƒ W S 1 s”0    Y  W n4 tyÔ } z| d	||¡ ‚ W Y d}~n
d}~0 0 dS )
z6Fetch the metadata for a package from the npm registryr\  )ÚsafeÚAcceptzHapplication/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8, */*)ÚheaderszFetching URL: %sr/   Nz+Failed to fetch package metadata for %r: %r)r   r
   r	   r>   Úfull_urlÚAttributeErrorÚget_full_urlÚ
contextlibÚclosingr   rþ   rÿ   r   r  r   rT  )r¬   rÇ   r<   ÚreqÚresponseÚexcrH   rH   rI   rß  ‚	  s    ÿþ8rß  Ú__main__)N)N)N)N)N)N)N)NN)NNF)NFNN)N)NNNNFNTT)N)Nrâ   )Nrâ   )FN)N)N)N)N)N)N)N)FF)FF)N)F)Šr³   rG  rµ  r  rR   rþ   r¥   rl   Úos.pathr‚   rf   r/  r„  ry   r�  r?   rU   rû   r…  r   r   Úpathlibr   Útempfiler   Ú	threadingr   Úurllib.errorr   Úurllib.requestr   r	   r
   r   Zjupyter_core.pathsr   Z(jupyter_server.extension.serverextensionr   r   r   r   Zjupyterlab_server.configr   r   r   r   r   Zjupyterlab_server.processr   r   r   r   Zpackaging.versionr   Z	traitletsr   r   r   r   r   r    Zjupyterlab._versionr!   Zjupyterlab.coreconfigr#   Zjupyterlab.jlpmappr$   r%   Zjupyterlab.semverr&   r'   r(   r)   r*   r+   r0  r˜   rg   r]   r…   rŠ   r«  r¯   r-   ri   ro   rp   r   r„   r‡   rŒ   r�   r‘   r—   rš   r›   r¼   r”   rÃ   rÆ   rÊ   rÙ   r‰   rá   rè   ré   rê   rì   rí   rî   rï   rñ   rô   r  r¾   r½   r®   r;   r  r×   rþ  rÖ   ra  rÐ  rs  r¯  r  ræ  rk  rÈ  r¼  r   r8  rt  r=  rØ  rß  rc   rH   rH   rH   rI   Ú<module>   sÞ     
A 





@





#        ø


	
	



	
	

          U+
	
5


]


