HEX
Server: Apache/2.4.52 (Ubuntu)
System: Linux spn-python 5.15.0-89-generic #99-Ubuntu SMP Mon Oct 30 20:42:41 UTC 2023 x86_64
User: arjun (1000)
PHP: 8.1.2-1ubuntu2.20
Disabled: NONE
Upload Files
File: //lib/python3/dist-packages/twisted/internet/__pycache__/base.cpython-312.pyc
�

�b ��
��UdZddlZddlZddlZddlmZmZddlmZm	Z	m
Z
ddlmZddl
mZddlmZmZmZmZmZmZmZmZmZmZmZmZddlmZmZdd	lm Z m!Z!m"Z"m#Z#m$Z$m%Z%dd
l&m'Z(m)Z*m+Z,ddl-m.Z.m/Z/ddl0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:m;Z;m<Z<m=Z=m>Z>dd
l?m@Z@ddlAmBZBmCZCddlDmEZEddlFmGZGmHZIerddlJmKZKddlAmLZLeGj��rddlNmOZOndZOee3�Gd�d��ZPee<�Gd�d��ZQee<�Gd�d��ZRedefZSeeSeeTdfeeUeTffZVedeeUeSeeTdfeeUeTff�ZWGd�d�ZXee7e8�Gd�d��ZYed eeUeWf�ZZeedefeeTdfeeUeTffZ[ee6e:e>�Gd!�d"eY��Z\eGj��r	ee\e9�ee2�Gd#�d$e��Z]Gd%�d&e j��Z_Gd'�d(�Z`gZaeeUebd)<y)*z8
Very basic functionality for a Reactor implementation.
�N)�ABC�abstractmethod)�heapify�heappop�heappush)�format_stack)�	FrameType)�
TYPE_CHECKING�Any�Callable�Dict�List�NewType�Optional�Sequence�Set�Tuple�Union�cast)�classImplements�implementer)�abstract�defer�error�fdesc�main�threads)�ComplexResolverSimplifier�GAIResolver�SimpleResolverComplexifier)�Deferred�DeferredList)�IAddress�
IConnector�IDelayedCall�IHostnameResolver�	IProtocol�IReactorCore�IReactorPluggableNameResolver�IReactorPluggableResolver�IReactorThreads�IReactorTime�IReadDescriptor�IResolverSimple�IWriteDescriptor�_ISupportsExitSignalCapturing)�
ClientFactory)�log�reflect)�Failure)�platform�seconds)�Client)�
threadable)�
ThreadPoolc��eZdZUdZdZeeed<efde	de
defdee
deee
fd	e
dgdfd
e
dgdfde
ge	fddfd
�Zde	fd�Zdd�Zde	ddfd�Zde	ddfd�Zdd�Zdefd�Zde
defd�Zde
defd�Zdefd�Zy)�DelayedCallFN�_repr�time�func.�args�kw�cancel�resetr6�returnc���||||f\|_|_|_|_||_||_||_dx|_|_d|_	|jrt�dd|_yy)aR
        @param time: Seconds from the epoch at which to call C{func}.
        @param func: The callable to call.
        @param args: The positional arguments to pass to the callable.
        @param kw: The keyword arguments to pass to the callable.
        @param cancel: A callable which will be called with this
            DelayedCall before cancellation.
        @param reset: A callable which will be called with this
            DelayedCall after changing this DelayedCall's scheduled
            execution time. The callable should adjust any necessary
            scheduling details to ensure this DelayedCall is invoked
            at the new appropriate time.
        @param seconds: If provided, a no-argument callable which will be
            used to determine the current time any time that information is
            needed.
        r�N���)
r=r>r?r@�resetter�	cancellerr6�	cancelled�called�delayed_time�debugr�creator)�selfr=r>r?r@rArBr6s        �7/usr/lib/python3/dist-packages/twisted/internet/base.py�__init__zDelayedCall.__init__Ssj��448��t�R�3G�0��	�4�9�d�i�����
�������'(�(���������:�:�'�>�#�2�.�D�L��c�4�|j|jzS)z�
        Return the time at which this call will fire

        @return: The number of seconds after the epoch at which this call is
            scheduled to be made.
        �r=rK�rNs rO�getTimezDelayedCall.getTimevs���y�y�4�,�,�,�,rQc���|jrtj�|jrtj�|j|�d|_|jrt|�|_|`	|`
|`y)z�
        Unschedule this call

        @raise AlreadyCancelled: Raised if this call has already been
            unscheduled.

        @raise AlreadyCalled: Raised if this call has already been made.
        �N)rIr�AlreadyCancelledrJ�
AlreadyCalledrHrL�reprr<r>r?r@rTs rOrAzDelayedCall.cancels\���>�>��(�(�(�
�[�[��%�%�%��N�N�4� ��D�N��z�z�!�$�Z��
��	�4�9�d�grQ�secondsFromNowc� �|jrtj�|jrtj�|j�|z}||jkr d|_||_|j|�y||jz
|_y)aY
        Reschedule this call for a different time

        @param secondsFromNow: The number of seconds from the time of the
            C{reset} call at which this call will be scheduled.

        @raise AlreadyCancelled: Raised if this call has been cancelled.
        @raise AlreadyCalled: Raised if this call has already been made.
        rEN)	rIrrXrJrYr6r=rKrG)rNr[�newTimes   rOrBzDelayedCall.reset�sr���>�>��(�(�(�
�[�[��%�%�%��l�l�n�~�5�G�����"�$'��!�#��	��
�
�d�#�$+�d�i�i�$7��!rQ�secondsLaterc��|jrtj�|jrtj�|xj
|z
c_|j
dkr"|j
�|j|�yy)aQ
        Reschedule this call for a later time

        @param secondsLater: The number of seconds after the originally
            scheduled time for which to reschedule this call.

        @raise AlreadyCancelled: Raised if this call has been cancelled.
        @raise AlreadyCalled: Raised if this call has already been made.
        rEN)rIrrXrJrYrK�activate_delayrG)rNr^s  rO�delayzDelayedCall.delay�sf���>�>��(�(�(�
�[�[��%�%�%�����-��� � �3�&��#�#�%��
�
�d�#�'rQc�P�|xj|jz
c_d|_y)NrErSrTs rOr`zDelayedCall.activate_delay�s���	�	�T�&�&�&�	���rQc�8�|jxs|jS)z�Determine whether this call is still pending

        @return: True if this call has not yet been made or cancelled,
            False otherwise.
        )rIrJrTs rO�activezDelayedCall.active�s���N�N�1�d�k�k�2�2rQ�otherc�`�t|t�r|j|jkStS)z�
        Implement C{<=} operator between two L{DelayedCall} instances.

        Comparison is based on the C{time} attribute (unadjusted by the
        delayed time).
        ��
isinstancer;r=�NotImplemented�rNres  rO�__le__zDelayedCall.__le__�s'���e�[�)��9�9��
�
�*�*�!�!rQc�`�t|t�r|j|jkStS)z�
        Implement C{<} operator between two L{DelayedCall} instances.

        Comparison is based on the C{time} attribute (unadjusted by the
        delayed time).
        rgrjs  rO�__lt__zDelayedCall.__lt__�s'���e�[�)��9�9�u�z�z�)�)�!�!rQc
��|j�|jSt|d�rtt|jdd�}|�9t|jdd�}|� t|jdd�}|�|�d|��}|�"t	j
|j�}nd}|j
�}dt|�|j|z
|j|jfzg}|��|jd|d	f�|jrh|jd
j|jD�cgc]}t	j
|���c}��|jr|jd
�|jrc|jd
j|jj!�D��cgc]\}}|�dt	j
|�����!c}}��|jd�|j"r-|jd
dj|j$�z�|jd�dj|�Scc}wcc}}w)z�
        Implement C{repr()} for L{DelayedCall} instances.

        @returns: String containing details of the L{DelayedCall}.
        Nr>�__qualname__�__name__�im_class�.z.<DelayedCall 0x%x [%ss] called=%s cancelled=%s� �(z, �=�)z

traceback at creation: 

%sz    �>�)r<�hasattr�getattrr>r3�	safe_reprr6�idr=rJrI�extendr?�append�joinr@�itemsrLrM)rNr>�imClass�now�L�e�k�vs        rO�__repr__zDelayedCall.__repr__�s����:�:�!��:�:���4�� ��4�9�9�n�d�;�D��|��t�y�y�*�d�;���#�%�d�i�i��T�B�G��*�")��!�D�6�2���|��(�(����3���D��l�l�n��<��$�x����S��$�+�+�t�~�~�F�
G�
����
�H�H�c�4��%�&��y�y�������$�)�)�#L�)�Q�G�$5�$5�a�$8�)�#L�M�N��7�7��H�H�T�N��w�w�����I�I�EI�W�W�]�]�_�U�_�6�A�q�A�3�a�� 1� 1�!� 4�5�6�_�U���

�H�H�S�M��:�:�
�H�H�8�F�K�K����<U�V�W�	����
��w�w�q�z���$M��Vs�&I�)$I
�rCN)rp�
__module__rorLr<r�str�__annotations__�runtimeSeconds�floatrrr�objectr
rPrUrArBrar`�boolrdrkrmr��rQrOr;r;Ks"��

�E��E�8�C�=��(6�!/��!/��s�C�x� �!/��v��	!/�

��f���!/��-��$�.�/�
!/�����-�.�!/��"�e�)�$�!/�
�!/�F-��-�.�(8�E�8�d�8�.$�%�$�D�$�( �3��3�
"�F�
"�t�
"�
"�F�
"�t�
"�.�#�.rQr;c��eZdZdZdd�Zdededefd�Zdedeeddfd	�Z	d
ededeeddfd�Z
	ddedeedeefd
�Z
y)�ThreadedResolvera�
    L{ThreadedResolver} uses a reactor, a threadpool, and
    L{socket.gethostbyname} to perform name lookups without blocking the
    reactor thread.  It also supports timeouts indepedently from whatever
    timeout logic L{socket.gethostbyname} might have.

    @ivar reactor: The reactor the threadpool of which will be used to call
        L{socket.gethostbyname} and the I/O thread of which the result will be
        delivered.
    rCNc� �||_i|_y�N)�reactor�_runningQueries)rNr�s  rOrPzThreadedResolver.__init__ s�����
�	
�rQ�name�errc�N�tjd|�d|���}t|�S)N�address z not found: )r�DNSLookupErrorr4)rNr�r��lookupErrors    rO�_failzThreadedResolver._fail&s*���*�*�X�d�X�\�#��+O�P���{�#�#rQ�lookupDeferredc��|j|\}}|j|=|j|j|d��y)Nz
timeout error)r��errbackr�)rNr�r��userDeferred�
cancelCalls     rO�_cleanupzThreadedResolver._cleanup*s>��#'�#7�#7��#G� ��j�� � ��0����T�Z�Z��o�>�?rQ�resultc�$�	|j|\}}|j|=|j�t|t�r0|j	|j||j
���y|j|�y#t$rYywxYwr�)	r�rArhr4r�r��getErrorMessage�callback�KeyError)rNr�r�r�r�r�s      rO�
_checkTimeoutzThreadedResolver._checkTimeout/s���	.�'+�';�';�N�'K�$�L�*��$�$�^�4������&�'�*��$�$�T�Z�Z��f�6L�6L�6N�%O�P��%�%�f�-���	��	�s�B�	B�B�timeoutc��|rt|�}nd}t�}tj|jtt|j�j�tj|�}tt|j�j||j||�}||f|j|<|j|j||�|S)a1
        See L{twisted.internet.interfaces.IResolverSimple.getHostByName}.

        Note that the elements of C{timeout} are summed and the result is used
        as a timeout for the lookup.  Any intermediate timeout or retry logic
        is left up to the platform via L{socket.gethostbyname}.
        �<)�sumr!r�deferToThreadPoolr�rr+�
getThreadPool�socket�
gethostbynamer,�	callLaterr�r��addBothr�)rNr�r��timeoutDelayr�r�r�s       rO�
getHostByNamezThreadedResolver.getHostByName?s�����w�<�L��L�&.�j�� �2�2��L�L���$�,�,�/�=�=�?�� � ��	
���,����5�?�?��$�-�-��~�
�
�1=�j�/I����^�,����t�1�1�4��H��rQ)r��ReactorBaserCN�)rW���-)rpr�ro�__doc__rPr�r4r�r!r�r�r�intr�r�rQrOr�r�s���	��$�#�$�C�$�G�$�@�S�@�(�3�-�@�D�@�
.��.�!$�.�6>�s�m�.�	
�.�"3A����"*�3�-��	�#��rQr�c�0�eZdZ	ddedeedeefd�Zy)�BlockingResolverr�r�rCc���	tj|�}tj|�S#t$r3d|�d�}tj|�}tj|�cYSwxYw)Nr�z
 not found)r�r�r�succeed�OSErrorrr��fail)rNr�r��address�msgr�s      rOr�zBlockingResolver.getHostByName^se��	*��*�*�4�0�G��=�=��)�)���	#��T�H�J�/�C��&�&�s�+�C��:�:�c�?�"�	#�s�,�9A(�'A(Nr�)rpr�ror�rr�r!r�r�rQrOr�r�\s-��3A�
*��
*�"*�3�-�
*�	�#��
*rQr�.�_ThreePhaseEventTriggerHandlec
�|�eZdZdZdd�Zdededededef
d	�Z	d
eddfd�Z
d
eddfd�Zd
eddfd
�Zdd�Z
deddfd�Zy)�_ThreePhaseEventa�
    Collection of callables (with arguments) which can be invoked as a group in
    a particular order.

    This provides the underlying implementation for the reactor's system event
    triggers.  An instance of this class tracks triggers for all phases of a
    single type of event.

    @ivar before: A list of the before-phase triggers containing three-tuples
        of a callable, a tuple of positional arguments, and a dict of keyword
        arguments

    @ivar finishedBefore: A list of the before-phase triggers which have
        already been executed.  This is only populated in the C{'BEFORE'} state.

    @ivar during: A list of the during-phase triggers containing three-tuples
        of a callable, a tuple of positional arguments, and a dict of keyword
        arguments

    @ivar after: A list of the after-phase triggers containing three-tuples
        of a callable, a tuple of positional arguments, and a dict of keyword
        arguments

    @ivar state: A string indicating what is currently going on with this
        object.  One of C{'BASE'} (for when nothing in particular is happening;
        this is the initial value), C{'BEFORE'} (when the before-phase triggers
        are in the process of being executed).
    rCNc�<�g|_g|_g|_d|_y)N�BASE)�before�during�after�staterTs rOrPz_ThreePhaseEvent.__init__�s��57���57���46��
���
rQ�phase�callabler?�kwargsc�z�|dvrtd��t||�j|||f�t||||f�S)a�
        Add a trigger to the indicate phase.

        @param phase: One of C{'before'}, C{'during'}, or C{'after'}.

        @param callable: An object to be called when this event is triggered.
        @param args: Positional arguments to pass to C{callable}.
        @param kwargs: Keyword arguments to pass to C{callable}.

        @return: An opaque handle which may be passed to L{removeTrigger} to
            reverse the effects of calling this method.
        �r�r�r��
invalid phase)r�rzr~r�)rNr�r�r?r�s     rO�
addTriggerz_ThreePhaseEvent.addTrigger�sH��&�5�5��?�+�+���e��#�#�X�t�V�$<�=�,�e�X�t�V�-L�M�MrQ�handlec�B�t|d|jz�|�y)aS
        Remove a previously added trigger callable.

        @param handle: An object previously returned by L{addTrigger}.  The
            trigger added by that call will be removed.

        @raise ValueError: If the trigger associated with C{handle} has already
            been removed or if C{handle} is not a valid handle.
        �removeTrigger_N)rzr�)rNr�s  rO�
removeTriggerz_ThreePhaseEvent.removeTrigger�s��	5���&����3�4�V�<rQc��	|\}}}}|dvrtd��t||�j|||f�y#ttf$rt	d��wxYw)zN
        Just try to remove the trigger.

        @see: removeTrigger
        r�r�zinvalid trigger handleN)r�rz�remove�	TypeError�
ValueError�rNr�r�r�r?r�s      rO�removeTrigger_BASEz#_ThreePhaseEvent.removeTrigger_BASE�sj��	B�,2�)�E�8�T�6��9�9���/�/��D�%� �'�'��4��(@�A���:�&�	7��5�6�6�	7�s	�7�Ac��|\}}}}|dk7r|j|�S|||f|jvrtjdtd��y|j|�y)z�
        Remove the trigger if it has yet to be executed, otherwise emit a
        warning that in the future an exception will be raised when removing an
        already-executed trigger.

        @see: removeTrigger
        r�zdRemoving already-fired system event triggers will raise an exception in a future version of Twisted.r�)�category�
stacklevelN)r��finishedBefore�warnings�warn�DeprecationWarningr�s      rO�removeTrigger_BEFOREz%_ThreePhaseEvent.removeTrigger_BEFORE�sg��)/�%��x��v��H���*�*�6�2�2��d�F�#�t�':�':�:��M�M�<�+��	
�
�#�#�F�+rQc��d|_g|_g}|jru|jjd�\}}}|jj	|||f�	||i|��}t|t�r|j	|�	|jr�ut|�j|j�y#t$rtj�Y�QwxYw)z8
        Call the triggers added to this event.
        �BEFORErN)
r�r�r��popr~rhr!�
BaseExceptionr2r�r"�addCallback�_continueFiring)rN�
beforeResultsr�r?r�r�s      rO�	fireEventz_ThreePhaseEvent.fireEvent�s�����
� ���02�
��k�k�%)�[�[�_�_�Q�%7�"�H�d�F����&�&��$��'?�@�
1�!�4�2�6�2���f�h�/�!�(�(��0��k�k�	�]�#�/�/��0D�0D�E��!�
����	�
�s�B7�7C�C�ignoredc���d|_g|_|j|jfD]&}|s�|j	d�\}}}	||i|��|r�!�(y#t
$rt
j�Y�%wxYw)zJ
        Call the during and after phase triggers for this event.
        r�rN)r�r�r�r�r�r�r2r�)rNr�r�r�r?r�s      rOr�z _ThreePhaseEvent._continueFiring�sr����
� ����[�[�$�*�*�,�E��).���1��&��$����d�-�f�-��-��
%���G�G�I��s�A�A1�0A1r�)rpr�ror�rPr��_ThreePhaseEventTriggerCallabler�r�r�r�r�r�r�r�r�rQrOr�r�us����:�N��N�2�N��	N�
�N�
'�
N�0
=�$A�
=�d�
=�
B�)F�
B�4�
B�,�+H�,�T�,�*F�&�v��$�rQr�c�z�eZdZUdZe�Zeed<ee�Z	e
ed<dedefd�Zde
de
fd�Ze
de
fd��Zy)	�PluggableResolverMixinz�
    A mixin which implements the pluggable resolver reactor interfaces.

    @ivar resolver: The installed L{IResolverSimple}.
    @ivar _nameResolver: The installed L{IHostnameResolver}.
    �resolver�
_nameResolverrCc�z�tj|�sJ�|j}||_t|�|_|S)z�
        See L{IReactorPluggableResolver}.

        @param resolver: see L{IReactorPluggableResolver}.

        @return: see L{IReactorPluggableResolver}.
        )r.�
providedByr��_SimpleResolverComplexifierr�)rNr��oldResolvers   rO�installResolverz&PluggableResolverMixin.installResolvers;���)�)�(�3�3�3��m�m�� ��
�8��B����rQc�L�|j}||_t|�|_|S)z�
        See L{IReactorPluggableNameResolver}.

        @param resolver: See L{IReactorPluggableNameResolver}.

        @return: see L{IReactorPluggableNameResolver}.
        )r��_ComplexResolverSimplifierr�)rNr��previousNameResolvers   rO�installNameResolverz*PluggableResolverMixin.installNameResolvers*�� $�1�1��%���2�8�<��
�#�#rQc��|jS)zd
        Implementation of read-only
        L{IReactorPluggableNameResolver.nameResolver}.
        )r�rTs rO�nameResolverz#PluggableResolverMixin.nameResolver,s���!�!�!rQN)rpr�ror�r�r�r.r�r�r�r&r�r��propertyrr�rQrOr�r�sj���!1� 2�H�o�2�'B�8�'L�M�$�L����O��$�,=�$�BS�$��"�/�"��"rQr��_SystemEventIDc�|��eZdZdZdZdZdZdZdZdZdD�fd�Z	dZ
dDd�ZdDd	�Zd
e
eddfd�Zdeddfd
�Zdeddfd�Zdeddfd�Zdeddfd�Zdeeeeffd�Zdeefd�Zdeefd�Z	dEdedeedeefd�ZdDd�Z dDd�Z!dFdede
e"ddfd�Z#dFdede
e"ddfd�Z$dFdede
e"ddfd�Z%dDd�Z&dGd
eddfd �Z'd!eddfd"�Z(d#ed!ed$e)d%e*fd&e+d'e+de,fd(�Z-d)e,ddfd*�Z.d$e)d%e*fd&e+d'e+de
e,fd+�Z/dDd,�Z0dDd-�Z1dDd.�Z2e3e4�Z5d
ed$e)d%e*fd&e+d/e+de6f
d0�Z7d1e6ddfd2�Z8d1e6ddfd3�Z9dee:fd4�Z;dDd5�Z<de
efd6�Z=dDd7�Z>e?j��rNeA�J�dZBdZCdZDdDd8�ZEd9e)d%e*fd&e+d'e+ddfd:�ZFdDd;�ZGdDd<�ZHdDd=�ZIdeAfd>�ZJd?e)d%e*fd&e+d'e+ddfd@�ZKdAeddfdB�ZL�xZMSd9e)d%e*fd&e+d'e+ddfdC�ZF�xZMS)Hr�a�
    Default base class for Reactors.

    @ivar _stopped: A flag which is true between paired calls to C{reactor.run}
        and C{reactor.stop}.  This should be replaced with an explicit state
        machine.
    @ivar _justStopped: A flag which is true between the time C{reactor.stop}
        is called and the time the shutdown system event is fired.  This is
        used to determine whether that event should be fired after each
        iteration through the mainloop.  This should be replaced with an
        explicit state machine.
    @ivar _started: A flag which is true from the time C{reactor.run} is called
        until the time C{reactor.run} returns.  This is used to prevent calls
        to C{reactor.run} on a running reactor.  This should be replaced with
        an explicit state machine.
    @ivar running: See L{IReactorCore.running}
    @ivar _registerAsIOThread: A flag controlling whether the reactor will
        register the thread it is running in as the I/O thread when it starts.
        If C{True}, registration will be done, otherwise it will not be.
    @ivar _exitSignal: See L{_ISupportsExitSignalCapturing._exitSignal}
    TFN�twisted.internet.reactorrCc����t�|��g|_i|_g|_g|_d|_d|_d|_d|_	d|_
t�|_d|_
|jdd|j�|jdd|j �|jdd|j"�t%j&�r|j)�|j+�y)NrFr��startup�shutdown)�superrP�threadCallQueue�_eventTriggers�_pendingTimedCalls�_newTimedCalls�_cancellations�running�_started�_justStopped�_startedBefore�set�_internalReaders�waker�addSystemEventTrigger�_reallyStartRunning�crash�
disconnectAllr5�supportsThreads�_initThreads�installWaker)rN�	__class__s �rOrPzReactorBase.__init__Zs����
����24���;=���57���13�����������
�!���#���+.�%�����
�
	
�"�"�8�Y��8P�8P�Q��"�"�8�Z����D��"�"�8�Z��9K�9K�L��#�#�%��������rQc�X�ttj|j�dz��)Nz did not implement installWaker��NotImplementedErrorr3�qualrrTs rOrzReactorBase.installWakery�%��!��L�L����(�+L�L�
�	
rQc�R�|jr|jj�yy)z)
        Wake up the event loop.
        N)r�wakeUprTs rOr#zReactorBase.wakeUp~s ���:�:��J�J����rQrac�X�ttj|j�dz��)zV
        Do one iteration over the readers and writers which have been added.
        z did not implement doIterationr�rNras  rO�doIterationzReactorBase.doIteration�s'��"��L�L����(�+K�K�
�	
rQ�readerc�X�ttj|j�dz��)Nz did not implement addReaderr�rNr's  rO�	addReaderzReactorBase.addReader��%��!��L�L����(�+I�I�
�	
rQ�writerc�X�ttj|j�dz��)Nz did not implement addWriterr�rNr,s  rO�	addWriterzReactorBase.addWriter�r+rQc�X�ttj|j�dz��)Nz did not implement removeReaderrr)s  rO�removeReaderzReactorBase.removeReader�r!rQc�X�ttj|j�dz��)Nz did not implement removeWriterrr.s  rO�removeWriterzReactorBase.removeWriter�r!rQc�X�ttj|j�dz��)Nz did not implement removeAllrrTs rO�	removeAllzReactorBase.removeAll�r+rQc�X�ttj|j�dz��)Nz did not implement getReadersrrTs rO�
getReaderszReactorBase.getReaders��%��!��L�L����(�+J�J�
�	
rQc�X�ttj|j�dz��)Nz did not implement getWritersrrTs rO�
getWriterszReactorBase.getWriters�r8rQr�r�c��|stjd�Stj|�rtj|�S|jj||�S)z8
        Return a Deferred that will resolve a hostname.z0.0.0.0)rr�r�isIPAddressr�r�)rNr�r�s   rO�resolvezReactorBase.resolve�sJ��
��=�=��+�+�����%��=�=��&�&��}�}�*�*�4��9�9rQc�p�|jrtjd��d|_d|_d|_y)zD
        See twisted.internet.interfaces.IReactorCore.stop.
        z&Can't stop reactor that isn't running.TN)�_stoppedr�ReactorNotRunningrrrTs rO�stopzReactorBase.stop�s4���=�=��)�)�*R�S�S���
� ���"��rQc�Z�d|_d|_|jdd|j�y)z�
        See twisted.internet.interfaces.IReactorCore.crash.

        Reset reactor state tracking attributes and re-initialize certain
        state-transition helpers which were set up in C{__init__} but later
        destroyed (through use).
        Fr�rN)rrrrrTs rOrzReactorBase.crash�s*����
�����"�"�8�Y��8P�8P�QrQ�number�framec�r�tjd�|j|j�||_y)z�
        Handle a SIGINT interrupt.

        @param number: See handler specification in L{signal.signal}
        @param frame: See handler specification in L{signal.signal}
        zReceived SIGINT, shutting down.N�r2r��callFromThreadrA�_exitSignal�rNrCrDs   rO�sigIntzReactorBase.sigInt�s+��	���1�2����D�I�I�&�!��rQc�r�tjd�|j|j�||_y)z�
        Handle a SIGBREAK interrupt.

        @param number: See handler specification in L{signal.signal}
        @param frame: See handler specification in L{signal.signal}
        z!Received SIGBREAK, shutting down.NrFrIs   rO�sigBreakzReactorBase.sigBreak�s+��	���3�4����D�I�I�&�!��rQc�r�tjd�|j|j�||_y)z�
        Handle a SIGTERM interrupt.

        @param number: See handler specification in L{signal.signal}
        @param frame: See handler specification in L{signal.signal}
        z Received SIGTERM, shutting down.NrFrIs   rO�sigTermzReactorBase.sigTerm�s+��	���2�3����D�I�I�&�!��rQc��|j�}|D]:}tj||jt	t
j���<y)z2Disconnect every reader, and writer in the system.N)r5r2�callWithLogger�connectionLostr4r�CONNECTION_LOST)rN�selectablesr's   rOrzReactorBase.disconnectAll�s>���n�n�&��!�F������-�-�w�t�7K�7K�/L�
�"rQc�F�|j�|j|�y)zG
        See twisted.internet.interfaces.IReactorCore.iterate.
        N)�runUntilCurrentr&r%s  rO�iteratezReactorBase.iterate�s��	
��������rQ�	eventTypec�`�|jj|�}|�|j�yy)zO
        See twisted.internet.interfaces.IReactorCore.fireSystemEvent.
        N)r
�getr�)rNrW�events   rO�fireSystemEventzReactorBase.fireSystemEvents/���#�#�'�'�	�2�����O�O��rQr�r�.r?r�c���tj|�s
J|�d���||jvrt�|j|<t	||j|j
||g|��i|��f�S)zU
        See twisted.internet.interfaces.IReactorCore.addSystemEventTrigger.
        � is not callable)�builtinsr�r
r�rr�)rNr�rWr�r?r�s      rOrz!ReactorBase.addSystemEventTrigger
s���� � ��*�I�x�j�8H�,I�I�*��D�/�/�/�-=�-?�D���	�*���9��#�#�I�.�9�9��8��&*��.4��
�
�	
rQ�	triggerIDc�J�|\}}|j|j|�y)zX
        See twisted.internet.interfaces.IReactorCore.removeSystemEventTrigger.
        N)r
r�)rNr_rWr�s    rO�removeSystemEventTriggerz$ReactorBase.removeSystemEventTrigger$s'��&��	�6����I�&�4�4�V�<rQc�\�|jr	||i|��y|jdd|g|��i|��S)zO
        See twisted.internet.interfaces.IReactorCore.callWhenRunning.
        Nr�r)rr)rNr�r?r�s    rO�callWhenRunningzReactorBase.callWhenRunning+sG���<�<��d�%�f�%��-�4�-�-���H��/3��7=��
rQc��|jrtj��|jrtj��d|_d|_|jrtj�|jd�y)a�
        Method called when reactor starts: do some initialization and fire
        startup events.

        Don't call this directly, call reactor.run() instead: it should take
        care of calling this.

        This method is somewhat misnamed.  The reactor will not necessarily be
        in the running state by the time this method returns.  The only
        guarantee is that it will be on its way to the running state.
        TFrN)
rr�ReactorAlreadyRunningr�ReactorNotRestartabler?�_registerAsIOThreadr8�registerAsIOThreadr[rTs rO�startRunningzReactorBase.startRunning9sc���=�=��-�-�/�/�����-�-�/�/���
���
��#�#��)�)�+����Y�'rQc��d|_y)z�
        Method called to transition to the running state.  This should happen
        in the I{during startup} event trigger phase.
        TN)rrTs rOrzReactorBase._reallyStartRunningOs��
��rQc��t��r�)rrTs rO�runzReactorBase.runVs��!�#�#rQr@c	��tj|�s
J|�d���|dk\s
J|�d���t|j�|z||||j|j
|j��}|jj|�|S)zI
        See twisted.internet.interfaces.IReactorTime.callLater.
        r]rz* is not greater than or equal to 0 seconds)r6)r^r�r;r6�_cancelCallLater�_moveCallLaterSoonerrr~)rNrar�r?r@�delayedCalls      rOr�zReactorBase.callLater^s���� � ��*�I�x�j�8H�,I�I�*���z�O�e�W�$N�O�O�z�!��L�L�N�U�"�����!�!��%�%��L�L�
��	
���"�"�;�/��rQrpc��|j}	|j|�}||}|dk7r!|dz
dz}|||krn||||<|}|dk7r�!|||<y#t$rYywxYw)NrrW�)r�indexr�)rNrp�heap�pos�elt�parents      rOroz ReactorBase._moveCallLaterSoonerrs����&�&��	��*�*�[�)�C��s�)�C���(���'�a�����<�3�&�� ��L��S�	���
��(��D��I���	��	�s�;A�
A�	A�Ac�.�|xjdz
c_y�NrW)r
)rNrps  rOrnzReactorBase._cancelCallLater�s�����q� �rQc�r�|j|jzD�cgc]}|js|��c}Scc}w)zQ
        See L{twisted.internet.interfaces.IReactorTime.getDelayedCalls}
        )rrrI)rN�xs  rO�getDelayedCallszReactorBase.getDelayedCalls�sA���-�-��0C�0C�C�
�C���;�;�
�C�
�	
��
s�4c���|jD]J}|jr|xjdzc_�%|j�t	|j
|��Lg|_yry)rrIr
r`rr)rN�calls  rO�_insertNewDelayedCallsz"ReactorBase._insertNewDelayedCalls�sP���'�'�D��~�~��#�#�q�(�#��#�#�%���0�0�$�7�(�!��rQc��|j�|jsy|jdj|j�z
}d}t	dt||��S)z�
        Determine the longest time the reactor may sleep (waiting on I/O
        notification, perhaps) before it must wake up to service a time-related
        event.

        @return: The maximum number of seconds the reactor may sleep.
        Nri�� )rrr=r6�max�min)rNra�longests   rOr�zReactorBase.timeout�sZ��	
�#�#�%��&�&���'�'��*�/�/�$�,�,�.�@�����1�c�'�5�)�*�*rQc���|jrld}t|j�}|jD]\}}}	||i|��|dz
}||k(s�n|jd|�=|jr|j�|j
�|j�}|jr�|jdj|kr�t|j�}|jr|xjdzc_�_|jdkDr'|j�t|j|���	d|_|j"|j$i|j&��|jr|jdj|kr��|jdkDrm|jt|j�dz	kDrHd|_|jD�	cgc]}	|	jr�|	��c}	|_t7|j�|j8rd|_|j;d
�yy#t$rtj�Y��wxYw#t$r�tj(�t+|d�rbd}|dz
}|dz
}|d	j-|j.�j1�j3dd
�z
}|dz
}tj4|�Y��}wxYwcc}	w)z.
        Run all pending timed calls.
        rrWNrErM�
z? C: previous exception occurred in a DelayedCall created here:
z C:rxz
 C:�2Fr)r	�lenr�r2r�r#rr6rr=rrIr
rKr`rrJr>r?r@�deferrryrrM�rstrip�replacer�rrr[)
rN�count�total�f�ar@r�r~r�r{s
          rOrUzReactorBase.runUntilCurrent�s�������E���,�,�-�E�"�2�2�
��A�r���q�K�B�K���
���E�>��3��$�$�V�e�V�,��#�#����
�	
�#�#�%��l�l�n���%�%�4�+B�+B�1�+E�+J�+J�c�+Q��4�2�2�3�D��~�~��#�#�q�(�#��� � �3�&��#�#�%���0�0�$�7��
������	�	�4�9�9�0����0��%�%�4�+B�+B�1�+E�+J�+J�c�+Q�8
���"�$��#�#�c�$�*A�*A�&B�a�&G�G�"#�D���2�2�'�2�a�!�+�+��2�'�D�#�
�D�+�+�,���� %�D��� � ��,���e%���G�G�I���6!�
��
�
���4��+��A��:��A���J�A��������.�5�5�7�?�?��g�N�N�A���I�A��G�G�A�J��
��$'s0�H'�/-I�K� K�'I�I�BK�Kc�\�|jt||j��d|_y)NT)r��_GAIResolverr��usingThreadsrTs rOrzReactorBase._initThreadss%���$�$�\�$��8J�8J�%K�L� $�D�rQr�c��t|�s
J|�d���|jj|||f�|j�y)zl
            See
            L{twisted.internet.interfaces.IReactorFromThreads.callFromThread}.
            r]N)r�r	r~r#�rNr�r?r�s    rOrGzReactorBase.callFromThreadsC���A�;�6�1�#�%5� 6�6�;�
� � �'�'��D�&�(9�:��K�K�MrQc��tddd�|_|j|jj�|_|jdd|j�|_y)zO
            Create the threadpool accessible with callFromThread.
            r�
rr�rN)r9�
threadpoolrc�start�_threadpoolStartupIDr�_stopThreadPool�threadpoolShutdownIDrTs rO�_initThreadPoolzReactorBase._initThreadPoolsR��)��B�0J�K�D�O�(,�(<�(<�T�_�_�=R�=R�(S�D�%�(,�(B�(B��*�d�&:�&:�)�D�%rQc��yr�r�rTs rO�_uninstallHandlerzReactorBase._uninstallHandler$s��rQc��|j|jg}td|�D]}	|j|��d|_d|_|j
�J�|j
j
�d|_y#t$rY�`wxYw)a4
            Stop the reactor threadpool.  This method is only valid if there
            is currently a threadpool (created by L{_initThreadPool}).  It
            is not intended to be called directly; instead, it will be
            called by a shutdown trigger created in L{_initThreadPool}.
            N)r�r��filterrar�r�rA)rN�triggers�triggers   rOr�zReactorBase._stopThreadPool's����1�1�4�3L�3L�M�H�!�$��1����1�1�'�:�2�
)-�D�%�(,�D�%��?�?�.�.�.��O�O� � �"�"�D�O��
"����s�A:�:	B�Bc�n�|j�|j�|j�J�|jS)z[
            See L{twisted.internet.interfaces.IReactorThreads.getThreadPool}.
            )r�r�rTs rOr�zReactorBase.getThreadPool:s4�����&��$�$�&����2�2�2��?�?�"rQ�	_callablec�L�|j�j|g|��i|��y)z\
            See L{twisted.internet.interfaces.IReactorInThreads.callInThread}.
            N)r��callInThread)rNr�r?r�s    rOr�zReactorBase.callInThreadFs'��
.�D��� �-�-�i�I�$�I�&�IrQ�sizec�D�|j�j|��y)zc
            See L{twisted.internet.interfaces.IReactorThreads.suggestThreadPoolSize}.
            )�
maxthreadsN)r��adjustPoolsize)rNr�s  rO�suggestThreadPoolSizez!ReactorBase.suggestThreadPoolSizeNs��
��� �/�/�4�/�@rQc�j�t|�s
J|�d���|jj|||f�y)Nr])r�r	r~r�s    rOrGzReactorBase.callFromThreadVs8���A�;�6�1�#�%5� 6�6�;�� � �'�'��D�&�(9�:rQr�r�r�)rE)Nrpr�ror�rgr?�	installedr�rHrP�_lockrr#rr�r&r-r*r/r/r1r3rrr5r7r:r�rr�r!r=rArr	rJrLrNrrVr[rrr�rrrarcrirrl�staticmethodr�r6r;r�rornr%r|rr�rUr5rr9r�r�r�rrGr�r�r�r�r�r��
__classcell__)rs@rOr�r�9s�����,���H��I��L��K�)�H��:
�E�
�
 �
��%��
�T�
�
��
�D�
�

� 0�
�T�
�

�?�
�t�
�

�#3�
��
�

�4��o�7G�&G� H�I�
�

�D��1�
�

�D�!1�2�
�3A�
:��
:�"*�3�-�
:�	�#��
:�#�
R�	"�S�	"��)�)<�	"��	"�	"�s�	"�8�I�+>�	"�$�	"�	"�c�	"�(�9�*=�	"��	"�� �U� �T� ������
��
��
��3��8�$�	
�
�
��

�
�
�.=�.�=�T�=�� ��c��*��39��EK��	�.�	!��(�,�$��>�*�G����&.�s�C�x�&8��AG��OU��	��(�����(!�K�!�D�!�
��,�!7�
�!�+��%��+�8A-�H �x���!��%�%�%��
�#��#��	%�	��c�3�h�'�	�06�	�BH�	�
�	�	�	�	#�&	#�:�	#�	J�%�c�3�h�/�	J�8>�	J�JP�	J�
�	J�	A�c�	A�d�	A�	;��c�3�h�'�	;�06�	;�BH�	;�
�	;rQr�c��eZdZdZdZdZdedededdfd�Z	dd	�Z
edd
��Zdd�Z
dd�Zdd
�Zdedeefd�Zdeddfd�Zdeddfd�Zdefd�Zdefd�Zy)�
BaseConnectorzm
    Basic implementation of L{IConnector}.

    State can be: "connecting", "connected", "disconnected"
    Nr�factoryr�r�rCc�<�d|_||_||_||_y)N�disconnected)r�r�r�r�)rNr�r�r�s    rOrPzBaseConnector.__init__ms ��$��
���������rQc��|jdk(r|j�y|jdk(r)|j�J�|jj�yy)z!Disconnect whatever our state is.�
connecting�	connectedN)r��stopConnecting�	transport�loseConnectionrTs rO�
disconnectzBaseConnector.disconnectusK���:�:��%����!�
�Z�Z�;�
&��>�>�-�-�-��N�N�)�)�+�'rQc��yr�r�rTs rO�_makeTransportzBaseConnector._makeTransport}s��rQc��|jdk7rtd��d|_|js!|jj	�d|_|j�|_|j�R|jj|j|jjtj��|_
|jj|�y)z"Start connection to remote server.r�zcan't connect in this stater�rWN)r��RuntimeError�factoryStartedr��doStartr�r�r�r�r��failIfNotConnectedr�TimeoutError�	timeoutID�startedConnectingrTs rO�connectzBaseConnector.connect�s����:�:��'��<�=�=�!��
��"�"��L�L� � �"�"#�D��+/�+>�+>�+@����<�<�#�!�\�\�3�3����d�n�n�?�?��AS�AS�AU��D�N�	
���&�&�t�,rQc���|jdk7rtjd��|j�J�d|_|jj	tj
��|`y)zStop attempting to connect.r�zwe're not trying to connectNr�)r�r�NotConnectingErrorr�r��	UserErrorrTs rOr�zBaseConnector.stopConnecting�sU���:�:��%��*�*�+H�I�I��~�~�)�)�)�#��
����)�)�%�/�/�*;�<��NrQc�v�|j�	|jj�|`yy#t$rY�wxYwr�)r�rAr�rTs rO�
cancelTimeoutzBaseConnector.cancelTimeout�sA���>�>�%�
����%�%�'���&���
��
�s�,�	8�8�addrc�f�d|_|j�|jj|�S)Nr�)r�r�r��
buildProtocol)rNr�s  rOr�zBaseConnector.buildProtocol�s*�� ��
������|�|�)�)�$�/�/rQ�reasonc���|j�d|_d|_|jj	||�|jdk(r"|jj�d|_yy�Nr�r)r�r�r�r��clientConnectionFailed�doStopr��rNr�s  rO�connectionFailedzBaseConnector.connectionFailed�sY���������#��
����+�+�D�&�9��:�:��'��L�L���!�"#�D��(rQc��d|_|jj||�|jdk(r"|jj�d|_yyr�)r�r��clientConnectionLostr�r�r�s  rOrQzBaseConnector.connectionLost�sF��#��
����)�)�$��7��:�:��'��L�L���!�"#�D��(rQc�X�ttj|j�dz��)Nz! did not implement getDestinationrrTs rO�getDestinationzBaseConnector.getDestination�s%��!��L�L����(�+Q�Q�
�	
rQc��djtj|j�t	|�|j
|j
��S)Nz<{} instance at 0x{:x} {} {}>)�formatr3r rr|r�r�rTs rOr�zBaseConnector.__repr__�s?��.�5�5��L�L����(��t�H��J�J����!�	
�	
rQr�)rCr7)rpr�ror�r�r�r1r�r�rPr�rr�r�r�r�r#rr'r�r4r�rQr�r�r�r�rQrOr�r�bs�����I��N��$��/4��?J��	
��,��
��
�-� ��0�(�0�x�	�/B�0�
$�w�$�4�$�$�W�$��$�
��
�

�#�
rQr�c��eZdZUdZdZejed<dZejed<dej
fd�Z
deefd�Z
y)�BasePortziBasic implementation of a ListeningPort.

    Note: This does not actually implement IListeningPort.
    N�
addressFamily�
socketTyperCc���tj|j|j�}|jd�t	j
|j
��|S)NF)r�r�r��setblockingr�_setCloseOnExec�fileno)rN�ss  rO�createInternetSocketzBasePort.createInternetSocket�sA���M�M�$�,�,�d�o�o�>��	�
�
�e��
���a�h�h�j�)��rQc�X�tdtj|j�z��)zRaises a RuntimeErrorzdoWrite called on a %s)r�r3r rrTs rO�doWritezBasePort.doWrite�s ���3�g�l�l�4�>�>�6R�R�S�SrQ)rpr�ror�r�r��
AddressFamilyr�r��
SocketKindr�rr4r�r�rQrOr�r��sL���
+/�M�6�'�'�.�$(�J��!�!�(��f�m�m��T��'�*�TrQr�c�P�eZdZdZdZdd�Zddeddfd�Zdd�Zddeddfd	�Z	dd
�Z
y)
�_SignalReactorMixina!
    Private mixin to manage signals: it installs signal handlers at start time,
    and define run method.

    It can only be used mixed in with L{ReactorBase}, and has to be defined
    first in the inheritance (so that method resolution order finds
    startRunning first).

    @ivar _installSignalHandlers: A flag which indicates whether any signal
        handlers will be installed during startup.  This includes handlers for
        SIGCHLD to monitor child processes, and SIGINT, SIGTERM, and SIGBREAK
        to stop the reactor.
    FrCNc��	ddl}t	t
|�}|j
|j�|jk(r&|j|j|j�|j|j|j�t|dd�}|�|j||j�yy#t$rtjd�YywxYw)zI
        Install the signal handlers for the Twisted event loop.
        rNzEWarning: signal module unavailable -- not installing signal handlers.�SIGBREAK)�signal�ImportErrorr2r�rr��	getsignal�SIGINT�default_int_handlerrJ�SIGTERMrNrzrL)rNr��reactorBaseSelfr�s    rO�_handleSignalsz"_SignalReactorMixin._handleSignals�s���	���{�D�1�����F�M�M�*�f�.H�.H�H��M�M�&�-�-��)?�)?�@��
�
�f�n�n�o�&=�&=�>��6�:�t�4�����M�M�(�O�$<�$<�=� ��!�	��G�G�2�
�
�	�s�B7�7C�C�installSignalHandlersc�X�||_tjtt|��y)aB
        Extend the base implementation in order to remember whether signal
        handlers should be installed later.

        @param installSignalHandlers: A flag which, if set, indicates that
            handlers for a number of (implementation-defined) signals should be
            installed during startup.
        N)�_installSignalHandlersr�rir�rNr�s  rOriz _SignalReactorMixin.startRunnings!��'<��#�� � ��k�4�!8�9rQc��tjtt|��|jr|j	�yy)z�
        Extend the base implementation by also installing signal handlers, if
        C{self._installSignalHandlers} is true.
        N)r�rrr�r�rTs rOrz'_SignalReactorMixin._reallyStartRunnings5��
	�'�'��[�$�(?�@��&�&�
���!�'rQc�H�|j|��|j�y)N)r�)ri�mainLoopr�s  rOrlz_SignalReactorMixin.run!s�����0E��F��
�
�rQc��tt|�}|jr~	|jrN|j�|j	�}|j
xr|}|j
|�|jr�Ntjd�|jr�}yy#t$r,tjd�tj�Y�CwxYw)NzMain loop terminated.zUnexpected error in main loop.)rr�rrUr�rr&r2r�r�r�)rNr��t2�ts    rOr�z_SignalReactorMixin.mainLoop%s����{�D�1���&�&�
1�%�.�.�$�3�3�5�(�0�0�2�B�'�/�/�6�B�A�#�/�/��2�
&�.�.����/�0��&�&��!�
����8�9����	�
�s�AB�2C�Cr�)T)rpr�ror�r�r�r�rirrlr�r�rQrOr�r��sD���#��>�2
:�$�
:�$�
:�
"������1rQr��__all__)cr�r^r�r��abcrr�heapqrrr�	tracebackr�typesr	�typingr
rrr
rrrrrrrr�zope.interfacerr�twisted.internetrrrrrr�twisted.internet._resolverrr�rr�r r��twisted.internet.deferr!r"�twisted.internet.interfacesr#r$r%r&r'r(r)r*r+r,r-r.r/r0�twisted.internet.protocolr1�twisted.pythonr2r3�twisted.python.failurer4�twisted.python.runtimer5r6r��twisted.internet.tcpr7r8r�twisted.python.threadpoolr9r;r�r�r�r�r��_ThreePhaseEventTriggerr�r�r�r�_ThreadCallr�r��FileDescriptorr�r�rr�r�rQrO�<module>rst��
�
�
��#�,�,�"��
�
�
�
�8�I�I���
:����� 4�'�*�F��+�&��8����4��J�
�\��D�D��D�N
�_��E�E��E�P
�_��*�*��*�#+�3��8�"4���#�U�6�3�;�%7��c�6�k�9J�J���!(�#�	�#�.��f�c�k�0B�D��f��DU�
U�V�!��K�K�\
�
*�,E�F�."�."�G�."�b�)�5��6S�1S�+T�U���H�S�#�X�&��f�c�k�(:�D��f��<M�M�N��
�\�<�)F�G�a;�(�a;�H�a;�H�8�����K��1�
�Z��b
�C�b
��b
�JT�x�&�&�T�(Y1�Y1�x���c��rQ