a
    ø£BeG'  ã                   @   sŒ   d 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m	Z	m
Z
 ddlmZmZ ddlmZ ddlmZmZ dd	lmZ G d
d„ deƒZdS )zKernel Provisioner Classesé    N)ÚTYPE_CHECKINGÚAnyÚDictÚListÚOptionalé   )ÚKernelConnectionInfoÚLocalPortCache)Úlaunch_kernel)Úis_local_ipÚ	local_ipsé   )ÚKernelProvisionerBasec                       s8  e Zd ZdZdZdZdZdZdZdZ	e
edœdd„ƒZee dœdd„Zee dœd	d
„Zeddœdd„Zd%eddœdd„Zd&eddœdd„Zeeddœdd„ƒZd'eddœdd„Zeeeef dœ‡ fdd„Zee eedœdd„Zeeeef eeef dœdd„ƒZedœ‡ fd d!„Z edd"œ‡ fd#d$„Z!‡  Z"S )(ÚLocalProvisionera0  
    :class:`LocalProvisioner` is a concrete class of ABC :py:class:`KernelProvisionerBase`
    and is the out-of-box default implementation used when no kernel provisioner is
    specified in the kernel specification (``kernel.json``).  It provides functional
    parity to existing applications by launching the kernel locally and using
    :class:`subprocess.Popen` to manage its lifecycle.

    This class is intended to be subclassed for customizing local kernel environments
    and serve as a reference implementation for other custom provisioners.
    NF)Úreturnc                 C   s
   | j d uS )N)Úprocess)Úself© r   úp/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/jupyter_client/provisioning/local_provisioner.pyÚhas_process#   s    zLocalProvisioner.has_processc                 Ã   s   d}| j r| j  ¡ }|S )zPoll the provisioner.r   )r   Úpoll)r   Úretr   r   r   r   '   s    
zLocalProvisioner.pollc                 Ã   sd   d}| j r`|  ¡ I dH du r.t d¡I dH  q
| j  ¡ }dD ]}t| j |ƒ}|r<| ¡  q<d| _ |S )z!Wait for the provisioner process.r   Ngš™™™™™¹?)ÚstdoutÚstderrÚstdin)r   r   ÚasyncioÚsleepÚwaitÚgetattrÚclose)r   r   ÚattrÚfidr   r   r   r   .   s    

zLocalProvisioner.wait)Úsignumr   c                 Ã   s‚   | j r~|tjkr6tjdkr6ddlm} || j jƒ dS | jrnt	t
dƒrnzt
 | j|¡ W dS  tyl   Y n0 | j  |¡ dS dS )aT  Sends a signal to the process group of the kernel (this
        usually includes the kernel and any subprocesses spawned by
        the kernel).

        Note that since only SIGTERM is supported on Windows, we will
        check if the desired signal is for interrupt and apply the
        applicable code on Windows in that case.
        Úwin32r   )Úsend_interruptNÚkillpg)r   ÚsignalÚSIGINTÚsysÚplatformZwin_interruptr$   Zwin32_interrupt_eventÚpgidÚhasattrÚosr%   ÚOSErrorÚsend_signal)r   r"   r$   r   r   r   r.   C   s    	zLocalProvisioner.send_signal)Úrestartr   c              
   Ã   s~   | j rzttdƒr<z|  tj¡I dH  W dS  ty:   Y n0 z| j  ¡  W n. tyx } zt |¡ W Y d}~n
d}~0 0 dS )z,Kill the provisioner and optionally restart.ÚSIGKILLN)	r   r+   r&   r.   r0   r-   Úkillr   Ú_tolerate_no_process©r   r/   Úer   r   r   r1   _   s    
zLocalProvisioner.killc              
   Ã   s~   | j rzttdƒr<z|  tj¡I dH  W dS  ty:   Y n0 z| j  ¡  W n. tyx } zt |¡ W Y d}~n
d}~0 0 dS )z1Terminate the provisioner and optionally restart.ÚSIGTERMN)	r   r+   r&   r.   r5   r-   Ú	terminater   r2   r3   r   r   r   r6   n   s    
zLocalProvisioner.terminate)Úos_errorr   c                 C   s>   t jdkr| jdkr:‚ n"ddlm} t| tƒr8| j|kr:‚ d S )Nr#   é   r   )ÚESRCH)r(   r)   ÚwinerrorÚerrnor9   Ú
isinstanceÚProcessLookupError)r7   r9   r   r   r   r2   }   s    

z%LocalProvisioner._tolerate_no_processc                 Ã   sh   | j rd|sdt ¡ }| jd | jd | jd | jd | jd f}|D ] }trXt|tƒsXJ ‚| |¡ qBdS )zFClean up the resources used by the provisioner and optionally restart.Ú
shell_portÚ
iopub_portÚ
stdin_portÚhb_portÚcontrol_portN)Úports_cachedr	   ÚinstanceÚconnection_infor   r<   ÚintZreturn_port)r   r/   ÚlpcZportsÚportr   r   r   ÚcleanupŒ   s    
ûzLocalProvisioner.cleanup)Úkwargsr   c                 ‹   s   | j }|rì|jdkr:t|jƒs:d|j› dtƒ › �}t|ƒ‚| dg ¡}|jr¦| js¦t	 
¡ }| |j¡|_| |j¡|_| |j¡|_| |j¡|_| |j¡|_d| _d|v rÌ|d  dd¡}|j|d	� n| ¡  | ¡ | _|j|d
�}n| dg ¡}| jj| }tƒ jf d|i|¤ŽI dH S )a  Perform any steps in preparation for kernel process launch.

        This includes applying additional substitutions to the kernel launch command and env.
        It also includes preparation of launch parameters.

        Returns the updated kwargs.
        Ztcpz@Can only launch a kernel on a local interface. This one is not: zc.Make sure that the '*_address' attributes are configured properly. Currently valid addresses are: Úextra_argumentsTÚenvZJPY_SESSION_NAMEÚ )Újupyter_session)rK   ÚcmdN)ÚparentÚ	transportr   Úipr   ÚRuntimeErrorÚpopZcache_portsrC   r	   rD   Zfind_available_portr>   r?   r@   rA   rB   ÚgetZwrite_connection_fileZget_connection_inforE   Zformat_kernel_cmdZkernel_specÚargvÚsuperÚ
pre_launch)r   rJ   ÚkmÚmsgrK   rG   rN   Z
kernel_cmd©Ú	__class__r   r   rX   �   s<    
ÿüÿ
ÿzLocalProvisioner.pre_launch)rO   rJ   r   c                 Ë   sf   t  |¡}t|fi |¤Ž| _d}ttdƒrPzt | jj¡}W n tyN   Y n0 | jj| _|| _	| j
S )zLaunch a kernel with a command.NÚgetpgid)r   Ú_scrub_kwargsr
   r   r+   r,   r]   Úpidr-   r*   rE   )r   rO   rJ   Úscrubbed_kwargsr*   r   r   r   r
   Ï   s    


zLocalProvisioner.launch_kernelc                 C   s*   ddg}|   ¡ }|D ]}| |d¡ q|S )z:Remove any keyword arguments that Popen does not tolerate.rK   Z	kernel_idN)ÚcopyrT   )rJ   Zkeywords_to_scrubr`   Úkwr   r   r   r^   Þ   s
    zLocalProvisioner._scrub_kwargsc                 ƒ   s,   t ƒ  ¡ I dH }| | j| j| jdœ¡ |S )zRCaptures the base information necessary for persistence relative to this instance.N)r_   r*   rR   )rW   Úget_provisioner_infoÚupdater_   r*   rR   ©r   Úprovisioner_infor[   r   r   rc   ç   s    z%LocalProvisioner.get_provisioner_info)rf   r   c                 ƒ   s4   t ƒ  |¡I dH  |d | _|d | _|d | _dS )zOLoads the base information necessary for persistence relative to this instance.Nr_   r*   rR   )rW   Úload_provisioner_infor_   r*   rR   re   r[   r   r   rg   í   s    

z&LocalProvisioner.load_provisioner_info)F)F)F)#Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   Z_exit_futurer_   r*   rR   rC   ÚpropertyÚboolr   r   rF   r   r   r.   r1   r6   Ústaticmethodr-   r2   rI   r   r   ÚstrrX   r   r   r
   r^   rc   rg   Ú__classcell__r   r   r[   r   r      s.   2"r   )rk   r   r,   r&   r(   Útypingr   r   r   r   r   Úconnectr   r	   Úlauncherr
   Zlocalinterfacesr   r   Zprovisioner_baser   r   r   r   r   r   Ú<module>   s   