§
    Ã$cÛ  ã                   ó@  — d Z ddlmZ ddlmZ ddlmZ ddlZddlmZ ddl	m
Z
 dgZ e¦   «         Z ed	¦  «        j         e¦   «         d
<   d„  e¦   «         d<    G d„ de¦  «        Z G d„ de¦  «        Zd„ Z e¦   «          ddlmZ  e e¦   «         d¦  «         dS )z 
Low-level waiting primitives.

é    )Úabsolute_import)Údivision)Úprint_functionN)Úget_hub_noargs)ÚConcurrentObjectUseErrorÚWaiterÚgreenletÚ
getcurrentc                  ó   — d S ©N© r   ó    ú0/usr/lib/python3/dist-packages/gevent/_waiter.pyú<lambda>r      s   €  D€ r   Úgreenlet_initc                   ón   — e Zd ZdZg d¢Zdd„Zd„ Zd„ Zd„ Zd„ Z	e
d	„ ¦   «         Zd
„ Zd„ Zd„ Zd„ Zd„ ZdS )r   a:  
    A low level communication utility for greenlets.

    Waiter is a wrapper around greenlet's ``switch()`` and ``throw()`` calls that makes them somewhat safer:

    * switching will occur only if the waiting greenlet is executing :meth:`get` method currently;
    * any error raised in the greenlet is handled inside :meth:`switch` and :meth:`throw`
    * if :meth:`switch`/:meth:`throw` is called before the receiver calls :meth:`get`, then :class:`Waiter`
      will store the value/exception. The following :meth:`get` will return the value/raise the exception.

    The :meth:`switch` and :meth:`throw` methods must only be called from the :class:`Hub` greenlet.
    The :meth:`get` method must be called from a greenlet other than :class:`Hub`.

        >>> from gevent.hub import Waiter
        >>> from gevent import get_hub
        >>> result = Waiter()
        >>> timer = get_hub().loop.timer(0.1)
        >>> timer.start(result.switch, 'hello from Waiter')
        >>> result.get() # blocks for 0.1 seconds
        'hello from Waiter'
        >>> timer.close()

    If switch is called before the greenlet gets a chance to call :meth:`get` then
    :class:`Waiter` stores the value.

        >>> from gevent.time import sleep
        >>> result = Waiter()
        >>> timer = get_hub().loop.timer(0.1)
        >>> timer.start(result.switch, 'hi from Waiter')
        >>> sleep(0.2)
        >>> result.get() # returns immediately without blocking
        'hi from Waiter'
        >>> timer.close()

    .. warning::

        This is a limited and dangerous way to communicate between
        greenlets. It can easily leave a greenlet unscheduled forever
        if used incorrectly. Consider using safer classes such as
        :class:`gevent.event.Event`, :class:`gevent.event.AsyncResult`,
        or :class:`gevent.queue.Queue`.
    )Úhubr	   ÚvalueÚ
_exceptionNc                 óh   — |€t          ¦   «         n|| _        d | _        d | _        t          | _        d S r   )Úget_hubr   r	   r   Ú_NONEr   ©Úselfr   s     r   Ú__init__zWaiter.__init__I   s.   € Ø # •7‘9”9�9°ˆŒØˆŒØˆŒ
ÝˆŒˆˆr   c                 ó:   — d | _         d | _        t          | _        d S r   )r	   r   r   r   ©r   s    r   ÚclearzWaiter.clearO   s   € ØˆŒØˆŒ
ÝˆŒˆˆr   c                 ó  — | j         t          u r dt          | ¦  «        j        ›d| j        ›d�S | j         €(dt          | ¦  «        j        ›d| j        ›d| j        ›d�S dt          | ¦  «        j        ›d| j        ›d| j        ›d�S )Nú<z
 greenlet=ú>z value=z
 exc_info=)r   r   ÚtypeÚ__name__r	   r   Úexc_infor   s    r   Ú__str__zWaiter.__str__T   sš   € ØŒ?�eÐ#Ð#Ð#Ý)-¨d©¬Ô)<Ð)<Ð)<¸d¼m¸m¸mÐLÐLØŒ?Ð"Ð"Ý26°t±*´*Ô2EÐ2EÐ2EÀtÄ}À}À}ÐVZÔV`ÐV`ÐV`ÐaÐað #å15°d±´Ô1DÐ1DÐ1DÀdÄmÀmÀmÐUYÔUbÐUbÐUbÐcÐcr   c                 ó   — | j         t          uS )z;Return true if and only if it holds a value or an exception©r   r   r   s    r   ÚreadyzWaiter.ready[   s   € àŒ¥eÐ+Ð+r   c                 ó   — | j         du S )z8Return true if and only if it is ready and holds a valueN)r   r   s    r   Ú
successfulzWaiter.successful_   s   € àŒ $Ð&Ð&r   c                 ó0   — | j         t          ur| j         S dS )zaHolds the exception info passed to :meth:`throw` if :meth:`throw` was called. Otherwise ``None``.Nr'   r   s    r   r$   zWaiter.exc_infoc   s!   € ð Œ?¥%Ð'Ð'Ø”?Ð"ð (Ð'r   c                 óþ   — | j         }|€|| _        d| _        dS t          ¦   «         | j        urt          d¦  «        ‚|j        }	  ||¦  «         dS #   | j        j        |gt          j	        ¦   «         ¢R Ž  Y dS xY w)z²
        Switch to the greenlet if one's available. Otherwise store the
        *value*.

        .. versionchanged:: 1.3b1
           The *value* is no longer optional.
        Nú7Can only use Waiter.switch method from the Hub greenlet)
r	   r   r   r
   r   ÚAssertionErrorÚswitchÚhandle_errorÚsysr$   )r   r   r	   r/   s       r   r/   zWaiter.switchi   s•   € ð ”=ˆØÐØˆDŒJØ"ˆDŒOˆOˆOå‰|Œ| 4¤8Ð+Ð+Ý$Ð%^Ñ_Ô_Ð_Ø”_ˆFð?Ø��u‘”���øð?Ø%�”Ô% fÐ>­s¬|©~¬~Ð>Ð>Ð>Ð>Ð>Ð>Ð>øøøs   ÁA Á&A<c                 ó,   — |                       |¦  «        S r   )r/   )r   Úargss     r   Úswitch_argszWaiter.switch_args~   s   € Ø�{Š{˜4Ñ Ô Ð r   c                 óä   — | j         }|€	|| _        dS t          ¦   «         | j        urt	          d¦  «        ‚|j        }	  ||Ž  dS #   | j        j        |gt          j        ¦   «         ¢R Ž  Y dS xY w)zWSwitch to the greenlet with the exception. If there's no greenlet, store the exception.Nr-   )	r	   r   r
   r   r.   Úthrowr0   r1   r$   )r   Ú
throw_argsr	   r6   s       r   r6   zWaiter.throw�   sŽ   € à”=ˆØÐØ(ˆDŒOˆOˆOå‰|Œ| 4¤8Ð+Ð+Ý$Ð%^Ñ_Ô_Ð_Ø”NˆEð>Ø��zÐ"Ð"Ð"Ð"øð>Ø%�”Ô% eÐ=­c¬l©n¬nÐ=Ð=Ð=Ð=Ð=Ð=Ð=øøøs   ¿A Á&A/c                 ó0  — | j         t          ur+| j         €| j        S  t          ¦   «         j        | j         Ž  dS | j        �t          d| j        ›�¦  «        ‚t          ¦   «         | _        	 | j                             ¦   «         d| _        S # d| _        w xY w)zbIf a value/an exception is stored, return/raise it. Otherwise until switch() or throw() is called.NzThis Waiter is already used by )	r   r   r   r
   r6   r	   r   r   r/   r   s    r   Úgetz
Waiter.get�   s™   € àŒ?¥%Ð'Ð'ØŒÐ&Ø”zÐ!Ø�J‰LŒLÔ ¤Ð0Ð0Ð0Ð0àŒ}Ð(Ý.Ð.ÐVZÔVcÐVcÐ/fÑgÔgÐgÝ&™LœLˆDŒMð%Ø”x—’Ñ(Ô(à $�”�ø �”Ð$Ð$Ð$Ð$s   Á,B Â	Bc                 ó€   — |j         €|                      |j        ¦  «         d S |                      |j         ¦  «         d S r   )Ú	exceptionr/   r   r6   )r   Úsources     r   Ú__call__zWaiter.__call__ž   s@   € ØÔÐ#Ø�KŠK˜œÑ%Ô%Ð%Ð%Ð%à�JŠJ�vÔ'Ñ(Ô(Ð(Ð(Ð(r   r   )r#   Ú
__module__Ú__qualname__Ú__doc__Ú	__slots__r   r   r%   r(   r*   Úpropertyr$   r/   r4   r6   r9   r=   r   r   r   r   r      så   € € € € € ð)ð )ðV ;Ð:Ð:€Ið ð  ð  ð  ð ð  ð  ð
dð dð dð,ð ,ð ,ð'ð 'ð 'ð ð#ð #ñ „Xð#ð
?ð ?ð ?ð*!ð !ð !ð>ð >ð >ð%ð %ð %ð)ð )ð )ð )ð )r   c                   ó,   — e Zd ZdZdgZdd„Zd„ Zd„ ZdS )ÚMultipleWaitera:  
    An internal extension of Waiter that can be used if multiple objects
    must be waited on, and there is a chance that in between waits greenlets
    might be switched out. All greenlets that switch to this waiter
    will have their value returned.

    This does not handle exceptions or throw methods.
    Ú_valuesNc                 óJ   — t                                | |¦  «         g | _        d S r   )r   r   rE   r   s     r   r   zMultipleWaiter.__init__´   s#   € Ý�Š˜˜cÑ"Ô"Ð"ð ˆŒˆˆr   c                 óp   — | j                              |¦  «         t                               | d¦  «         d S )NT)rE   Úappendr   r/   )r   r   s     r   r/   zMultipleWaiter.switch½   s2   € ØŒ×Ò˜EÑ"Ô"Ð"Ý�Š�d˜DÑ!Ô!Ð!Ð!Ð!r   c                 ó¬   — | j         s4t                               | ¦  «         t                               | ¦  «         | j                              d¦  «        S )Nr   )rE   r   r9   r   Úpopr   s    r   r9   zMultipleWaiter.getÁ   sF   € ØŒ|ð 	Ý�JŠJ�tÑÔÐÝ�LŠL˜ÑÔÐàŒ|×Ò Ñ"Ô"Ð"r   r   )r#   r>   r?   r@   rA   r   r/   r9   r   r   r   rD   rD   ©   sY   € € € € € ðð ð �€Iðð ð ð ð"ð "ð "ð#ð #ð #ð #ð #r   rD   c                  ó"   — t          ¦   «          d S r   )r   r   r   r   Ú_initrL   È   s   € Ý�O„O€O€O€Or   )Úimport_c_accelzgevent.__waiter)r@   Ú
__future__r   r   r   r1   Úgevent._hub_localr   r   Úgevent.exceptionsr   Ú__all__Úobjectr   Ú
__import__r
   Úlocalsr   rD   rL   Úgevent._utilrM   Úglobalsr   r   r   ú<module>rW      sh  ððð ð 'Ð &Ð &Ð &Ð &Ð &Ø Ð Ð Ð Ð Ð Ø %Ð %Ð %Ð %Ð %Ð %à 
€
€
€
à 7Ð 7Ð 7Ð 7Ð 7Ð 7Ø 6Ð 6Ð 6Ð 6Ð 6Ð 6ð ð€ð 	ˆ‰Œ€à#˜ JÑ/Ô/Ô:€€�„ˆÑ Ø(˜L€€�„ˆÑ ðG)ð G)ð G)ð G)ð G)ˆVñ G)ô G)ð G)ð\#ð #ð #ð #ð #�Vñ #ô #ð #ð>ð ð ð €�„€ð (Ð 'Ð 'Ð 'Ð 'Ð 'Ø €ˆwˆw‰yŒyÐ+Ñ ,Ô ,Ð ,Ð ,Ð ,r   