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: //usr/lib/python3/dist-packages/twisted/python/__pycache__/threadpool.cpython-312.pyc
�

�b�'���dZddlmZmZddlmZddlmZddl	m
Z
mZddlm
Z
ddlmZddlmZe�ZGd	�d
�Zy)z�
twisted.python.threadpool: a pool of threads to which we dispatch tasks.

In most cases you can just use C{reactor.callInThread} and friends
instead of creating a thread pool directly.
�)�Thread�current_thread)�List)�pool)�context�log)�
deprecated)�Failure)�Versionc��eZdZdZdZdZdZdZdZe	Z
eee
dddd	�d
��e��Zee�Zdd�Zed
��Zed��Zed��Zed��ZeZd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Zd�Z dd�Z!d�Z"y)�
ThreadPoola�
    This class (hopefully) generalizes the functionality of a pool of threads
    to which work can be dispatched.

    L{callInThread} and L{stop} should only be called from a single thread.

    @ivar started: Whether or not the thread pool is currently running.
    @type started: L{bool}

    @ivar threads: List of workers currently running in this thread pool.
    @type threads: L{list}

    @ivar _pool: A hook for testing.
    @type _pool: callable compatible with L{_pool}
    ��FN�Twisted��rzthreading.current_thread)�version�replacementc���|dk\sJd��||ksJd��|�_|�_|�_g�_�fd�}�fd�}�j	||��_y)ac
        Create a new threadpool.

        @param minthreads: minimum number of threads in the pool
        @type minthreads: L{int}

        @param maxthreads: maximum number of threads in the pool
        @type maxthreads: L{int}

        @param name: The name to give this threadpool; visible in log messages.
        @type name: native L{str}
        r�minimum is negative�minimum is greater than maximumc����j|d�j�i|��}�jj|�|S)N�name)�
threadFactory�
_generateName�threads�append)�a�kw�thread�selfs   ��;/usr/lib/python3/dist-packages/twisted/python/threadpool.py�trackingThreadFactoryz2ThreadPool.__init__.<locals>.trackingThreadFactoryLsJ���'�T�'�'����+�+�-��13��F�
�L�L����'��M�c�6���jsy�jS)Nr)�started�max�r!s�r"�currentLimitz)ThreadPool.__init__.<locals>.currentLimitSs����<�<���8�8�Or$N)�minr'rr�_pool�_team)r!�
minthreads�
maxthreadsrr#r)s`     r"�__init__zThreadPool.__init__8sf����Q��5� 5�5���Z�'�J�)J�J�'���������	�%'���	�	�
�Z�Z��.C�D��
r$c�h�|jj�}|j|jzS)a
        For legacy compatibility purposes, return a total number of workers.

        @return: the current number of workers, both idle and busy (but not
            those that have been quit by L{ThreadPool.adjustPoolsize})
        @rtype: L{int}
        )r,�
statistics�idleWorkerCount�busyWorkerCount)r!�statss  r"�workerszThreadPool.workersZs-���
�
�%�%�'���$�$�u�'<�'<�<�<r$c�R�dg|jj�jzS)z�
        For legacy compatibility purposes, return the number of busy workers as
        expressed by a list the length of that number.

        @return: the number of workers currently processing a work item.
        @rtype: L{list} of L{None}
        N)r,r1r3r(s r"�workingzThreadPool.workingfs$���v��
�
�-�-�/�?�?�?�?r$c�R�dg|jj�jzS)a,
        For legacy compatibility purposes, return the number of idle workers as
        expressed by a list the length of that number.

        @return: the number of workers currently alive (with an allocated
            thread) but waiting for new work.
        @rtype: L{list} of L{None}
        N)r,r1r2r(s r"�waiterszThreadPool.waitersqs$���v��
�
�-�-�/�?�?�?�?r$c�*��G�fd�d�}|�S)z�
        For legacy compatibility purposes, return an object with a C{qsize}
        method that indicates the amount of work not yet allocated to a worker.

        @return: an object with a C{qsize} method.
        c���eZdZ�fd�Zy)�$ThreadPool._queue.<locals>.NotAQueuec�L���jj�jS)a
                Pretend to be a Python threading Queue and return the
                number of as-yet-unconsumed tasks.

                @return: the amount of backlogged work not yet dispatched to a
                    worker.
                @rtype: L{int}
                )r,r1�backloggedWorkCount)�qr!s �r"�qsizez*ThreadPool._queue.<locals>.NotAQueue.qsize�s����z�z�,�,�.�B�B�Br$N)�__name__�
__module__�__qualname__r@r(s�r"�	NotAQueuer<�s	���	
Cr$rD�)r!rDs` r"�_queuezThreadPool._queue}s���
	C�
	C��{�r$c���d|_d|_|j�|jj	�j
}|r|jj
|�yy)z'
        Start the threadpool.
        FTN)�joinedr&�adjustPoolsizer,r1r>�grow)r!�backlogs  r"�startzThreadPool.start�sN�������������*�*�'�'�)�=�=����J�J�O�O�G�$�r$c�:�|jjd�y)z�
        Increase the number of available workers for the thread pool by 1, up
        to the maximum allowed by L{ThreadPool.max}.
        rN)r,rJr(s r"�startAWorkerzThreadPool.startAWorker�s��
	
�
�
����r$c�T�d|jxst|��d|j��S)z�
        Generate a name for a new pool thread.

        @return: A distinctive name for the thread.
        @rtype: native L{str}
        zPoolThread-�-)r�idr5r(s r"rzThreadPool._generateName�s)���T�Y�Y�2�"�T�(�3�1�T�\�\�N�C�Cr$c�:�|jjd�y)zn
        Decrease the number of available workers by 1, by quitting one as soon
        as it's idle.
        rN)r,�shrinkr(s r"�stopAWorkerzThreadPool.stopAWorker�s��
	
�
�
���!�r$c�t�t|d|�tj||j|j�y)N�__dict__)�setattrr
r/r*r'�r!�states  r"�__setstate__zThreadPool.__setstate__�s(����j�%�(����D�$�(�(�D�H�H�5r$c�F�i}|j|d<|j|d<|S)Nr*r')r*r'rXs  r"�__getstate__zThreadPool.__getstate__�s&�����x�x��e���x�x��e���r$c�2�|jd|g|��i|��y)a
        Call a callable object in a separate thread.

        @param func: callable object to be called in separate thread

        @param args: positional arguments to be passed to C{func}

        @param kw: keyword args to be passed to C{func}
        N)�callInThreadWithCallback)r!�func�argsrs    r"�callInThreadzThreadPool.callInThread�s ��	&��%�%�d�D�>�4�>�2�>r$c��������|jrytjj�jd��fd������fd��_|�_|jj��y)a$
        Call a callable object in a separate thread and call C{onResult} with
        the return value, or a L{twisted.python.failure.Failure} if the
        callable raises an exception.

        The callable is allowed to block, but the C{onResult} function must not
        block and should perform as little work as possible.

        A typical action for C{onResult} for a threadpool used with a Twisted
        reactor would be to schedule a L{twisted.internet.defer.Deferred} to
        fire in the main reactor thread using C{.callFromThread}.  Note that
        C{onResult} is called inside the separate thread, not inside the
        reactor thread.

        @param onResult: a callable with the signature C{(success, result)}.
            If the callable returns normally, C{onResult} is called with
            C{(True, result)} where C{result} is the return value of the
            callable.  If the callable throws an exception, C{onResult} is
            called with C{(False, failure)}.

            Optionally, C{onResult} may be L{None}, in which case it is not
            called at all.

        @param func: callable object to be called in separate thread

        @param args: positional arguments to be passed to C{func}

        @param kw: keyword arguments to be passed to C{func}
        N���c����	�j�}d}d�_�j��j||�d�_y|st	j
|�yy#t$rt�}d}Y�]wxYw)NTF)�theWork�
BaseExceptionr
�onResultr�err)�result�ok�	inContexts  �r"rkz6ThreadPool.callInThreadWithCallback.<locals>.inContext�sy���
�"�*�*�,����
!%�I���!�!�-��"�"�2�v�.�%)�	�"���������!�
� �����
�s�A�A3�2A3c�8��tj��g���i���S)N)r�call)r`�ctxr_rs����r"�<lambda>z5ThreadPool.callInThreadWithCallback.<locals>.<lambda>s#���G�L�L���%
��%
� "�%
r$)	rHr�theContextTracker�currentContext�contextsrergr,�do)r!rgr_r`rrnrks  ```@@r"r^z#ThreadPool.callInThreadWithCallback�sW���<�;�;���'�'�6�6�8�A�A�"�E��
	 �$
�	��&�	���
�
�
�
�i� r$c��d|_d|_|jj�|jD]}|j��y)z9
        Shutdown the threads in the threadpool.
        TFN)rHr&r,�quitr�join)r!r s  r"�stopzThreadPool.stops7���������
�
�����l�l�F��K�K�M�#r$c���|�|j}|�|j}|dk\sJd��||ksJd��||_||_|jsy|j|jkDr2|jj|j|jz
�|j|jkr3|jj
|j|jz
�yy)z�
        Adjust the number of available threads by setting C{min} and C{max} to
        new values.

        @param minthreads: The new value for L{ThreadPool.min}.

        @param maxthreads: The new value for L{ThreadPool.max}.
        Nrrr)r*r'r&r5r,rSrJ)r!r-r.s   r"rIzThreadPool.adjustPoolsizes��������J������J��Q��5� 5�5���Z�'�J�)J�J�'��������|�|���<�<�$�(�(�"��J�J���d�l�l�T�X�X�5�6��<�<�$�(�(�"��J�J�O�O�D�H�H�t�|�|�3�4�#r$c���tjd|j���tjd|j���tjd|j���y)zw
        Dump some plain-text informational messages to the log about the state
        of this L{ThreadPool}.
        z	waiters: z	workers: ztotal: N)r�msgr9r7rr(s r"�	dumpStatszThreadPool.dumpStats2sI��
	���)�D�L�L�>�*�+����)�D�L�L�>�*�+����'�$�,�,��(�)r$)rrN)NN)#rArBrC�__doc__r*r'rHr&rrr�staticmethodr	rr�
currentThreadr+r/�propertyr5r7r9rFr?rLrNrrTrZr\rar^rwrIr{rEr$r"r
r
s���� �C�
�C�
�F��G��D��M� �	
�
��I�r�1�a�0�2�	
��	��M�
���E� E�D�	=��	=��@��@��	@��	@�����,	�A�
%��D��6��
?�9!�v�5�:*r$r
N)r|�	threadingrr�typingr�twisted._threadsrr+�twisted.pythonrr�twisted.python.deprecater	�twisted.python.failurer
�twisted.python.versionsr�object�
WorkerStopr
rEr$r"�<module>r�s4��
�-��*�'�/�*�+�
�X�
�a*�a*r$