a
    ø£BeY=  ã                   @  sx  d 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
mZmZmZ ddlmZmZmZmZmZmZmZmZmZ ddlmZ ddlmZ ejjZd	Z G d
d„ deƒZ!e "dej#¡Z$dddœdd„Z%dZ&dddœdd„Z'dddœdd„Z(G dd„ de)ƒZ*G dd„ deƒZ+dd œd!d"„Z,ddd#œd$d%„Z-d/dddd'ddd(œd)d*„Z.e+j.j e._ d0dd+d,œd-d.„Z/e+j/j e/_ dS )1zTools for managing kernel specsé    )ÚannotationsN)ÚSYSTEM_JUPYTER_PATHÚjupyter_data_dirÚjupyter_path)	ÚBoolÚCaselessStrEnumÚDictÚ	HasTraitsÚListÚSetÚTypeÚUnicodeÚobserve)ÚLoggingConfigurableé   )ÚKernelProvisionerFactoryÚpython3c                   @  s‚   e Zd ZdZeƒ Zeƒ Zeƒ Zeƒ Z	eƒ Z
eƒ Zeƒ Zeddgdd�Zeƒ Zeddd dœdd	„ƒZd
dœdd„Zddœdd„ZdS )Ú
KernelSpeczA kernel spec model object.ÚmessageÚsignal)Údefault_valueztype[KernelSpec]Ústr)ÚclsÚresource_dirÚreturnc                 C  sR   t |dƒ}t|dd��}t |¡}W d  ƒ n1 s60    Y  | f d|i|¤ŽS )z|Create a KernelSpec object by reading kernel.json

        Pass the path to the *directory* containing kernel.json.
        úkernel.jsonzutf-8)ÚencodingNr   )ÚpjoinÚopenÚjsonÚload)r   r   Zkernel_fileÚfZkernel_dict© r"   ú\/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/jupyter_client/kernelspec.pyÚfrom_resource_dir%   s    
(zKernelSpec.from_resource_dirúdict[str, t.Any]©r   c                 C  s"   | j | j| j| j| j| jdœ}|S )z"Convert the kernel spec to a dict.©ÚargvÚenvÚdisplay_nameÚlanguageÚinterrupt_modeÚmetadatar'   )ÚselfÚdr"   r"   r#   Úto_dict0   s    ú	zKernelSpec.to_dictc                 C  s   t  |  ¡ ¡S )zOSerialise this kernelspec to a JSON object.

        Returns a string.
        )r   Údumpsr0   ©r.   r"   r"   r#   Úto_json=   s    zKernelSpec.to_jsonN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r
   r(   r   ÚnameÚmimetyper*   r+   r   r)   r   r   r,   r-   Úclassmethodr$   r0   r3   r"   r"   r"   r#   r      s   
r   z^[a-z0-9._\-]+$r   út.Any©r8   r   c                 C  s
   t  | ¡S )z"Check that a kernel name is valid.)Ú_kernel_name_patÚmatch©r8   r"   r"   r#   Ú_is_valid_kernel_nameH   s    r@   zuKernel names can only contain ASCII letters and numbers and these separators: - . _ (hyphen, period, and underscore).Úbool)Úpathr   c                 C  s   t j | ¡ot j t| dƒ¡S )zIs ``path`` a kernel directory?r   )ÚosrB   ÚisdirÚisfiler   )rB   r"   r"   r#   Ú_is_kernel_dirT   s    rF   ú
str | Noneúdict[str, str])Údirr   c                 C  sv   | du st j | ¡si S i }t  | ¡D ]J}t| |ƒ}t|ƒs>q&| ¡ }t|ƒshtj	dt
› d|› �dd� |||< q&|S )z…Return a mapping of kernel names to resource directories from dir.

    If dir is None or does not exist, returns an empty dict.
    Nz#Invalid kernelspec directory name (z): é   ©Ú
stacklevel)rC   rB   rD   Úlistdirr   rF   Úlowerr@   ÚwarningsÚwarnÚ_kernel_name_description)rI   Úkernelsr!   rB   Úkeyr"   r"   r#   Ú_list_kernels_inY   s    
þ
rT   c                   @  s.   e Zd ZdZdddœdd„Zddœdd	„Zd
S )ÚNoSuchKernelz7An error raised when there is no kernel of a give name.r   ÚNoner<   c                 C  s
   || _ dS )zInitialize the error.Nr?   )r.   r8   r"   r"   r#   Ú__init__r   s    zNoSuchKernel.__init__r&   c                 C  s   d| j › �S )NzNo such kernel named r?   r2   r"   r"   r#   Ú__str__v   s    zNoSuchKernel.__str__N)r4   r5   r6   r7   rW   rX   r"   r"   r"   r#   rU   o   s   rU   c                   @  sH  e Zd ZdZeeddd�Zedddd�Ze	ƒ Z
ddœdd	„Ze	ƒ Zddœd
d„Zeddd�Zeddd�Zedd�ZddiZeeeƒŽ dddœdd„ƒZddœdd„Zddœdd„Zddddœdd „Zdd!d"œd#d$„Zddd"œd%d&„Zd'dœd(d)„Zddd*œd+d,„Zd:dd/d!dd0œd1d2„Zd;dd!d/d3d!dd4œd5d6„Zd<d/dd7œd8d9„Z d.S )=ÚKernelSpecManagerzA manager for kernel specs.Tz„The kernel spec class.  This is configurable to allow
        subclassing of the KernelSpecManager for customized behavior.
        )ÚconfigÚhelpz†If there is no Python kernelspec registered and the IPython
        kernel is available, ensure it is added to the spec list.
        r   r&   c                 C  s   t ƒ S )N)r   r2   r"   r"   r#   Ú_data_dir_default�   s    z#KernelSpecManager._data_dir_defaultc                 C  s   t | jdƒS )NrR   )r   Údata_dirr2   r"   r"   r#   Ú_user_kernel_dir_default”   s    z*KernelSpecManager._user_kernel_dir_defaultz@Deprecated, use `KernelSpecManager.allowed_kernelspecs`
        z^List of allowed kernel names.

        By default, all installed kernels are allowed.
        zLList of kernel directories to search. Later ones take priority over earlier.)r[   Ú	whitelist)Úallowed_kernelspecsz7.0r;   rV   )Úchanger   c                 C  sl   |j }| j| \}}t| |ƒ}||jkrh| j | jj› d|› d|› d| jj› d|› d�
¡ t| ||jƒ dS )zobserver for deprecated traitsÚ.z! is deprecated in jupyter_client z, use z insteadN)	r8   Ú_deprecated_aliasesÚgetattrÚnewÚlogÚwarningÚ	__class__r4   Úsetattr)r.   ra   Úold_attrÚnew_attrÚversionÚ	new_valuer"   r"   r#   Ú_deprecated_trait­   s    

ÿÿÿÿz#KernelSpecManager._deprecated_traitz	list[str]c                 C  sF   t dƒ}z&ddlm} | tj |ƒ d¡¡ W n ty@   Y n0 |S )NrR   r   )Úget_ipython_dir)r   ZIPython.pathsro   ÚappendrC   rB   ÚjoinÚModuleNotFoundError)r.   Údirsro   r"   r"   r#   Ú_kernel_dirs_default½   s    z&KernelSpecManager._kernel_dirs_defaultrH   c                   sÂ   i }ˆ j D ]>}t|ƒ}| ¡ D ](\}}||vrˆ j d||¡ |||< qq
ˆ jr¢t|vr¢z(ddlm} ˆ j dt|¡ ||t< W n  t	y    ˆ j 
dt¡ Y n0 ˆ jr¾‡ fdd„| ¡ D ƒ}|S )ú<Returns a dict mapping kernel names to resource directories.zFound kernel %s in %sr   ©Ú	RESOURCESz$Native kernel (%s) available from %sz#Native kernel (%s) is not availablec                   s    i | ]\}}|ˆ j v r||“qS r"   )r`   )Ú.0r8   Úspecr2   r"   r#   Ú
<dictcomp>ã   ó    z7KernelSpecManager.find_kernel_specs.<locals>.<dictcomp>)Úkernel_dirsrT   Úitemsrf   ÚdebugÚensure_native_kernelÚNATIVE_KERNEL_NAMEÚipykernel.kernelspecrw   ÚImportErrorrg   r`   )r.   r/   Ú
kernel_dirrR   Úknamery   rw   r"   r2   r#   Úfind_kernel_specsÊ   s*    
ýz#KernelSpecManager.find_kernel_specsr   )Úkernel_namer   r   c                 C  s†   d}|t krVzddlm}m} W n ty2   Y n$0 ||krV|ƒ }| jf d|i|¤Ž}|sf| j |¡}tj| j	d� 
|¡s‚t|ƒ‚|S )zaReturns a :class:`KernelSpec` instance for a given kernel_name
        and resource_dir.
        Nr   )rw   Úget_kernel_dictr   )Úparent)r€   r�   rw   r‡   r‚   Úkernel_spec_classr$   ÚKPFÚinstancerˆ   Zis_provisioner_availablerU   )r.   r†   r   Zkspecrw   r‡   Zkdictr"   r"   r#   Ú_get_kernel_spec_by_nameç   s    z*KernelSpecManager._get_kernel_spec_by_namerG   ©r†   r   c                 C  sˆ   dd„ | j D ƒD ]B}t |¡}|D ].}t||ƒ}| ¡ |kr"t|ƒr"|    S q"q|tkr„zddlm} W n t	y~   Y n0 |S dS )z2Find the resource directory of a named kernel specc                 S  s   g | ]}t j |¡r|‘qS r"   )rC   rB   rD   )rx   Úkdr"   r"   r#   Ú
<listcomp>   r{   z:KernelSpecManager._find_spec_directory.<locals>.<listcomp>r   rv   N)
r|   rC   rM   r   rN   rF   r€   r�   rw   r‚   )r.   r†   rƒ   Úfilesr!   rB   rw   r"   r"   r#   Ú_find_spec_directoryþ   s    

z&KernelSpecManager._find_spec_directoryc                 C  sX   t |ƒs | j d|› dt› �¡ |  | ¡ ¡}|du rL| j d|¡ t|ƒ‚|  ||¡S )z•Returns a :class:`KernelSpec` instance for the given kernel_name.

        Raises :exc:`NoSuchKernel` if the given kernel name is not found.
        zKernelspec name z is invalid: Nz#Kernelspec name %s cannot be found!)r@   rf   rg   rQ   r‘   rN   rU   rŒ   )r.   r†   r   r"   r"   r#   Úget_kernel_spec  s    ÿz!KernelSpecManager.get_kernel_specr%   c              	   C  s�   |   ¡ }i }| ¡ D ]v\}}z8| jtu r6|  ||¡}n
|  |¡}|| ¡ dœ||< W q tyf   Y q tyˆ   | j	j
d|dd� Y q0 q|S )a*  Returns a dict mapping kernel names to kernelspecs.

        Returns a dict of the form::

            {
              'kernel_name': {
                'resource_dir': '/path/to/kernel_name',
                'spec': {"the spec itself": ...}
              },
              ...
            }
        )r   ry   zError loading kernelspec %rT)Úexc_info)r…   r}   rh   rY   rŒ   r’   r0   rU   Ú	Exceptionrf   rg   )r.   r/   Úresr„   r   ry   r"   r"   r#   Úget_all_specs!  s    

zKernelSpecManager.get_all_specsr<   c                 C  sd   | j }zd| _ |  ¡ }W || _ n|| _ 0 || }| j d|¡ tj |¡rVt |¡ n
t 	|¡ |S )z\Remove a kernel spec directory by name.

        Returns the path that was deleted.
        FzRemoving %s)
r   r…   rf   r~   rC   rB   ÚislinkÚremoveÚshutilÚrmtree)r.   r8   Zsave_nativeÚspecsZspec_dirr"   r"   r#   Úremove_kernel_specA  s    

z$KernelSpecManager.remove_kernel_specFNrA   )r†   ÚuserÚprefixr   c                 C  sL   |rt j | j|¡S |r4t j t j |¡ddd|¡S t j td d|¡S d S )NÚshareÚjupyterrR   r   )rC   rB   rq   Úuser_kernel_dirÚabspathr   )r.   r†   r�   rž   r"   r"   r#   Ú_get_destination_dirT  s
    z&KernelSpecManager._get_destination_dirúbool | None©Ú
source_dirr†   r�   Úreplacerž   r   c           	      C  sø   |  d¡}|stj |¡}| ¡ }t|ƒsBd|›dt› �}t|ƒ‚|rV|rVd}t|ƒ‚|durntj	dt
dd� | j|||d	�}| j d
|¡ tj |¡}|| jvr´| j d|| j¡ tj |¡rØ| j d|¡ t |¡ t ||¡ | j d||¡ |S )a#  Install a kernel spec by copying its directory.

        If ``kernel_name`` is not given, the basename of ``source_dir`` will
        be used.

        If ``user`` is False, it will attempt to install into the systemwide
        kernel registry. If the process does not have appropriate permissions,
        an :exc:`OSError` will be raised.

        If ``prefix`` is given, the kernelspec will be installed to
        PREFIX/share/jupyter/kernels/KERNEL_NAME. This can be sys.prefix
        for installation inside virtual or conda envs.
        z/\zInvalid kernel name z.  zCCan't specify both user and prefix. Please choose one or the other.NzTreplace is ignored. Installing a kernelspec always replaces an existing installationé   rK   )r�   rž   zInstalling kernelspec in %szFInstalling to %s, which is not in %s. The kernelspec may not be found.z"Removing existing kernelspec in %szInstalled kernelspec %s in %s)ÚrstriprC   rB   ÚbasenamerN   r@   rQ   Ú
ValueErrorrO   rP   ÚDeprecationWarningr£   rf   r~   Údirnamer|   rg   rD   Úinfor™   rš   Úcopytree)	r.   r¦   r†   r�   r§   rž   ÚmsgÚdestinationrƒ   r"   r"   r#   Úinstall_kernel_spec^  s>    
ü
ý
z%KernelSpecManager.install_kernel_spec©r�   r   c                 C  s*   t jddd� ddlm} || |d� dS )z,DEPRECATED: Use ipykernel.kernelspec.installzRinstall_native_kernel_spec is deprecated. Use ipykernel.kernelspec import install.r¨   rK   r   )Úinstall©r�   N)rO   rP   r�   r´   )r.   r�   r´   r"   r"   r#   Úinstall_native_kernel_specš  s    þz,KernelSpecManager.install_native_kernel_spec)FN)NFNN)F)!r4   r5   r6   r7   r   r   r‰   r   r   r   r]   r\   r¡   r^   r   r_   r`   r
   r|   rc   r   Úlistrn   rt   r…   rŒ   r‘   r’   r–   rœ   r£   r²   r¶   r"   r"   r"   r#   rY   z   sZ   ýýþþÿÿ
  ÿ    ú<rY   r&   c                   C  s
   t ƒ  ¡ S )ru   )rY   r…   r"   r"   r"   r#   r…   ¥  s    r…   r�   c                 C  s   t ƒ  | ¡S )z‚Returns a :class:`KernelSpec` instance for the given kernel_name.

    Raises KeyError if the given kernel name is not found.
    )rY   r’   )r†   r"   r"   r#   r’   ª  s    r’   Fr¤   r¥   c                 C  s   t ƒ  | ||||¡S )z+Install a kernel spec in a given directory.)rY   r²   )r¦   r†   r�   r§   rž   r"   r"   r#   r²   ²  s    r²   rV   r³   c                 C  s   t ƒ j| d� dS )zInstall the native kernel spec.rµ   N)rY   r¶   rµ   r"   r"   r#   r¶   À  s    r¶   )NFFN)F)0r7   Ú
__future__r   r   rC   Úrer™   ÚtypingÚtrO   Zjupyter_core.pathsr   r   r   Z	traitletsr   r   r   r	   r
   r   r   r   r   Ztraitlets.configr   Zprovisioningr   rŠ   rB   rq   r   r€   r   ÚcompileÚ
IGNORECASEr=   r@   rQ   rF   rT   ÚKeyErrorrU   rY   r…   r’   r²   r¶   r"   r"   r"   r#   Ú<module>   sD   ,-ÿ  -
    û
