a
    ø£BeÇ%  ã                   @  sV  d dl mZ d dlZd dlm  mZ d dlZd dl	m
Z
mZ d dlmZmZmZ d dlmZ d dlm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 e�r8d d	lm Z  d
dl!m"Z"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.m/Z/m0Z0m1Z1m2Z2 ddl3m4Z4 ddl5m6Z6 ddl7m8Z8 edƒZ9G dd„ de
d�Z:dS )é    )ÚannotationsN)ÚABCMetaÚabstractmethod)ÚAsyncIteratorÚ	AwaitableÚMapping)ÚPathLike)ÚSignals)ÚAddressFamilyÚ
SocketKindÚsocket)ÚIOÚTYPE_CHECKINGÚAnyÚCallableÚContextManagerÚSequenceÚTypeVarÚoverload)ÚLiteralé   )ÚCapacityLimiterÚEvent)ÚCancelScope)ÚTaskInfo)ÚBlockingPortalé   )ÚConnectedUDPSocketÚConnectedUNIXDatagramSocketÚIPSockAddrTypeÚSocketListenerÚSocketStreamÚ	UDPSocketÚUNIXDatagramSocketÚUNIXSocketStream)ÚProcess)Ú	TaskGroup)Ú
TestRunnerÚT_Retvalc                   @  s&  e Zd Zeeddddddœdd„ƒƒZeedd	œd
d„ƒƒZeedd	œdd„ƒƒZeedd	œdd„ƒƒZeedd	œdd„ƒƒZ	edd	œdd„ƒZ
edd	œdd„ƒZeedddœdd„ƒƒZeeejddœdddd œd!d"„ƒƒZeedd	œd#d$„ƒƒZeed%d	œd&d'„ƒƒZeed(d	œd)d*„ƒƒZeedd+d,œd-d.„ƒƒZeed—d0ddd1dd2œd3d4„ƒƒZeedd5ddd6œd7d8„ƒƒZeed0dddd6œd9d:„ƒƒZeed;d	œd<d=„ƒƒZeed/d/dd>œd?d@dAdAdAdBdCddDdEœ	dFdG„ƒƒZeed/d/dd>œdHdIdAdAdAdBdCddDdEœ	dJdG„ƒƒZeed/d/dd>œdKddAdAdAdBdCddDdEœ	dLdG„ƒƒZeedMddNœdOdP„ƒƒZeed˜dQdRdSdTdUœdVdW„ƒƒZeedQdXdYœdZd[„ƒƒZeed\d]d^œd_d`„ƒƒZeed\d]d^œdadb„ƒƒZeedcdSdSddddeœdfdg„ƒƒZeed\ddhdiœdjdk„ƒƒZ eed\dQdldiœdmdk„ƒƒZ eed\dndodiœdpdk„ƒƒZ eedqdqdqdqdrœdsdtdudvdRdRdwdxœdydz„ƒƒZ!eed™d{dRd|d}œd~d„ƒƒZ"eed\dd^œd€d�„ƒƒZ#eed\dd^œd‚dƒ„ƒƒZ$eed+d	œd„d…„ƒƒZ%eed†d‡dˆœd‰dŠ„ƒƒZ&eed‹d	œdŒd�„ƒƒZ'eedŽd	œd�d�„ƒƒZ(eedd	œd‘d’„ƒƒZ)eedd“d”œd•d–„ƒƒZ*d/S )šÚAsyncBackendz"Callable[..., Awaitable[T_Retval]]ztuple[Any, ...]zdict[str, Any]r(   )ÚfuncÚargsÚkwargsÚoptionsÚreturnc                 C  s   dS )aÕ  
        Run the given coroutine function in an asynchronous event loop.

        The current thread must not be already running an event loop.

        :param func: a coroutine function
        :param args: positional arguments to ``func``
        :param kwargs: positional arguments to ``func``
        :param options: keyword arguments to call the backend ``run()`` implementation
            with
        :return: the return value of the coroutine function
        N© )Úclsr*   r+   r,   r-   r/   r/   úW/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/anyio/abc/_eventloop.pyÚrun-   s    	zAsyncBackend.runÚobject)r.   c                 C  s   dS )z

        :return:
        Nr/   ©r0   r/   r/   r1   Úcurrent_tokenC   s    zAsyncBackend.current_tokenÚfloatc                 C  s   dS )zz
        Return the current value of the event loop's internal clock.

        :return: the clock value (seconds)
        Nr/   r4   r/   r/   r1   Úcurrent_timeK   s    zAsyncBackend.current_timeztype[BaseException]c                 C  s   dS )zFReturn the exception class that is raised in a task if it's cancelled.Nr/   r4   r/   r/   r1   Úcancelled_exception_classT   s    z&AsyncBackend.cancelled_exception_classÚNonec                 Ã  s   dS )zä
        Check if the task has been cancelled, and allow rescheduling of other tasks.

        This is effectively the same as running :meth:`checkpoint_if_cancelled` and then
        :meth:`cancel_shielded_checkpoint`.
        Nr/   r4   r/   r/   r1   Ú
checkpointY   s    zAsyncBackend.checkpointc                 Ã  s"   |   ¡ tj kr|  ¡ I dH  dS )z¾
        Check if the current task group has been cancelled.

        This will check if the task has been cancelled, but will not allow other tasks
        to be scheduled if not.

        N)Úcurrent_effective_deadlineÚmathÚinfr:   r4   r/   r/   r1   Úcheckpoint_if_cancelledc   s    	z$AsyncBackend.checkpoint_if_cancelledc                 Ã  s@   | j dd��  |  d¡I dH  W d  ƒ n1 s20    Y  dS )zà
        Allow the rescheduling of other tasks.

        This will give other tasks the opportunity to run, but without checking if the
        current task group has been cancelled, unlike with :meth:`checkpoint`.

        T)Úshieldr   N)Úcreate_cancel_scopeÚsleepr4   r/   r/   r1   Úcancel_shielded_checkpointo   s    	z'AsyncBackend.cancel_shielded_checkpoint)Údelayr.   c                 Ã  s   dS )zt
        Pause the current task for the specified duration.

        :param delay: the duration, in seconds
        Nr/   )r0   rC   r/   r/   r1   rA   {   s    zAsyncBackend.sleepF)Údeadliner?   Úboolr   )rD   r?   r.   c                C  s   d S ©Nr/   )r0   rD   r?   r/   r/   r1   r@   „   s    z AsyncBackend.create_cancel_scopec                 C  s   dS )aQ  
        Return the nearest deadline among all the cancel scopes effective for the
        current task.

        :return:
            - a clock value from the event loop's internal clock
            - ``inf`` if there is no deadline in effect
            - ``-inf`` if the current scope has been cancelled
        :rtype: float
        Nr/   r4   r/   r/   r1   r;   ‹   s    z'AsyncBackend.current_effective_deadliner&   c                 C  s   d S rF   r/   r4   r/   r/   r1   Úcreate_task_group™   s    zAsyncBackend.create_task_groupr   c                 C  s   d S rF   r/   r4   r/   r/   r1   Úcreate_eventž   s    zAsyncBackend.create_eventr   )Útotal_tokensr.   c                 C  s   d S rF   r/   )r0   rI   r/   r/   r1   Úcreate_capacity_limiter£   s    z$AsyncBackend.create_capacity_limiterNzCallable[..., T_Retval]zCapacityLimiter | None)r*   r+   ÚcancellableÚlimiterr.   c                 Ã  s   d S rF   r/   )r0   r*   r+   rK   rL   r/   r/   r1   Úrun_sync_in_worker_thread¨   s    	z&AsyncBackend.run_sync_in_worker_threadz
tuple[Any])r*   r+   Útokenr.   c                 C  s   d S rF   r/   ©r0   r*   r+   rN   r/   r/   r1   Úrun_async_from_thread³   s    z"AsyncBackend.run_async_from_threadc                 C  s   d S rF   r/   rO   r/   r/   r1   Úrun_sync_from_thread½   s    z!AsyncBackend.run_sync_from_threadr   c                 C  s   d S rF   r/   r4   r/   r/   r1   Úcreate_blocking_portalÄ   s    z#AsyncBackend.create_blocking_portal)ÚcwdÚenvÚstart_new_sessionzstr | byteszLiteral[True]zint | IO[Any] | Nonez"str | bytes | PathLike[str] | NonezMapping[str, str] | Noner%   )	ÚcommandÚshellÚstdinÚstdoutÚstderrrS   rT   rU   r.   c          	      Ã  s   d S rF   r/   ©	r0   rV   rW   rX   rY   rZ   rS   rT   rU   r/   r/   r1   Úopen_processÉ   s    zAsyncBackend.open_processzSequence[str | bytes]zLiteral[False]c          	      Ã  s   d S rF   r/   r[   r/   r/   r1   r\   Ù   s    z#str | bytes | Sequence[str | bytes]c          	      Ã  s   d S rF   r/   r[   r/   r/   r1   r\   é   s    zset[Process])Úworkersr.   c                 C  s   d S rF   r/   )r0   r]   r/   r/   r1   Ú#setup_process_pool_exit_at_shutdownù   s    z0AsyncBackend.setup_process_pool_exit_at_shutdownÚstrÚintzIPSockAddrType | Noner!   )ÚhostÚportÚlocal_addressr.   c                 Ã  s   d S rF   r/   )r0   ra   rb   rc   r/   r/   r1   Úconnect_tcpþ   s    zAsyncBackend.connect_tcpr$   )Úpathr.   c                 Ã  s   d S rF   r/   )r0   re   r/   r/   r1   Úconnect_unix  s    zAsyncBackend.connect_unixr   r    )Úsockr.   c                 C  s   d S rF   r/   ©r0   rg   r/   r/   r1   Úcreate_tcp_listener
  s    z AsyncBackend.create_tcp_listenerc                 C  s   d S rF   r/   rh   r/   r/   r1   Úcreate_unix_listener  s    z!AsyncBackend.create_unix_listenerr
   zUDPSocket | ConnectedUDPSocket)Úfamilyrc   Úremote_addressÚ
reuse_portr.   c                 Ã  s   d S rF   r/   )r0   rk   rc   rl   rm   r/   r/   r1   Úcreate_udp_socket  s    	zAsyncBackend.create_udp_socketr#   )Ú
raw_socketÚremote_pathr.   c                 Ã  s   d S rF   r/   ©r0   ro   rp   r/   r/   r1   Úcreate_unix_datagram_socket  s    z(AsyncBackend.create_unix_datagram_socketr   c                 Ã  s   d S rF   r/   rq   r/   r/   r1   rr   &  s    z
str | Nonez0UNIXDatagramSocket | ConnectedUNIXDatagramSocketc                 Ã  s   d S rF   r/   rq   r/   r/   r1   rr   -  s    r   )rk   ÚtypeÚprotoÚflagszbytes | str | Nonezstr | int | Nonezint | AddressFamilyzint | SocketKindz]list[tuple[AddressFamily, SocketKind, int, str, tuple[str, int] | tuple[str, int, int, int]]])ra   rb   rk   rs   rt   ru   r.   c                Ã  s   d S rF   r/   )r0   ra   rb   rk   rs   rt   ru   r/   r/   r1   Úgetaddrinfo4  s    zAsyncBackend.getaddrinfor   ztuple[str, str])Úsockaddrru   r.   c                 Ã  s   d S rF   r/   )r0   rw   ru   r/   r/   r1   ÚgetnameinfoJ  s    zAsyncBackend.getnameinfoc                 Ã  s   d S rF   r/   rh   r/   r/   r1   Úwait_socket_readableQ  s    z!AsyncBackend.wait_socket_readablec                 Ã  s   d S rF   r/   rh   r/   r/   r1   Úwait_socket_writableV  s    z!AsyncBackend.wait_socket_writablec                 C  s   d S rF   r/   r4   r/   r/   r1   Úcurrent_default_thread_limiter[  s    z+AsyncBackend.current_default_thread_limiterr	   z&ContextManager[AsyncIterator[Signals]])Úsignalsr.   c                 G  s   d S rF   r/   )r0   r|   r/   r/   r1   Úopen_signal_receiver`  s    z!AsyncBackend.open_signal_receiverr   c                 C  s   d S rF   r/   r4   r/   r/   r1   Úget_current_taskg  s    zAsyncBackend.get_current_taskzlist[TaskInfo]c                 C  s   d S rF   r/   r4   r/   r/   r1   Úget_running_tasksl  s    zAsyncBackend.get_running_tasksc                 Ã  s   d S rF   r/   r4   r/   r/   r1   Úwait_all_tasks_blockedq  s    z#AsyncBackend.wait_all_tasks_blockedr'   )r-   r.   c                 C  s   d S rF   r/   )r0   r-   r/   r/   r1   Úcreate_test_runnerv  s    zAsyncBackend.create_test_runner)FN)N)r   )+Ú__name__Ú
__module__Ú__qualname__Úclassmethodr   r2   r5   r7   r8   r:   r>   rB   rA   r<   r=   r@   r;   rG   rH   rJ   rM   rP   rQ   rR   r   r\   r^   rd   rf   ri   rj   rn   rr   rv   rx   ry   rz   r{   r}   r~   r   r€   r�   r/   r/   r/   r1   r)   ,   s
  ÿ  û		ö&	ö&	ö& ÿ	ø" ÿr)   )Ú	metaclass);Ú
__future__r   ÚbuiltinsÚ@py_builtinsÚ_pytest.assertion.rewriteÚ	assertionÚrewriteÚ
@pytest_arr<   Úabcr   r   Úcollections.abcr   r   r   Úosr   Úsignalr	   r   r
   r   Útypingr   r   r   r   r   r   r   r   r   Ú_core._synchronizationr   r   Ú_core._tasksr   Ú_core._testingr   Úfrom_threadr   Ú_socketsr   r   r   r    r!   r"   r#   r$   Ú_subprocessesr%   Ú_tasksr&   Ú_testingr'   r(   r)   r/   r/   r/   r1   Ú<module>   s&   "((
