
    \d                     P    d Z ddlZddlmZ ddlmZ d Zd Zd Z	d Z
d	 Zg d
ZdS )zY
Extended thread dispatching support.

For basic support see reactor threading API docs.
    N)defer)failurec                 `     t          j                     fd} |j        ||g|R i | S )a3  
    Call the function C{f} using a thread from the given threadpool and return
    the result as a Deferred.

    This function is only used by client code which is maintaining its own
    threadpool.  To run a function in the reactor's threadpool, use
    C{deferToThread}.

    @param reactor: The reactor in whose main thread the Deferred will be
        invoked.

    @param threadpool: An object which supports the C{callInThreadWithCallback}
        method of C{twisted.python.threadpool.ThreadPool}.

    @param f: The function to call.
    @param args: positional arguments to pass to f.
    @param kwargs: keyword arguments to pass to f.

    @return: A Deferred which fires a callback with the result of f, or an
        errback with a L{twisted.python.failure.Failure} if f throws an
        exception.
    c                 |    | r                     j        |           d S                      j        |           d S N)callFromThreadcallbackerrback)successresultdreactors     8lib/python3.11/site-packages/twisted/internet/threads.pyonResultz#deferToThreadPool.<locals>.onResult*   sG     	6""1:v66666""19f55555    )r   DeferredcallInThreadWithCallback)r   
threadpoolfargskwargsr   r   s   `     @r   deferToThreadPoolr      s]    . 	A6 6 6 6 6 6 (J'!EdEEEfEEEHr   c                 V    ddl m} t          ||                                | g|R i |S )at  
    Run a function in a thread and return the result as a Deferred.

    @param f: The function to call.
    @param args: positional arguments to pass to f.
    @param kwargs: keyword arguments to pass to f.

    @return: A Deferred which fires a callback with the result of f,
    or an errback with a L{twisted.python.failure.Failure} if f throws
    an exception.
    r   r   )twisted.internetr   r   getThreadPool)r   r   r   r   s       r   deferToThreadr   5   sD     )(((((Wg&;&;&=&=qR4RRR6RRRr   c                 (    | D ]\  }}} ||i | dS )z"
    Run a list of functions.
    N )	tupleListr   r   r   s       r   _runMultipler!   F   s;     %  4	46 r   c                 H    ddl m} |                    t          |            dS )z
    Run a list of functions in the same thread.

    tupleList should be a list of (function, argsList, kwargsDict) tuples.
    r   r   N)r   r   callInThreadr!   )r    r   s     r   callMultipleInThreadr$   N   s2     )(((((y11111r   c                     t          j                     fd}|                     |                                           }t          |t          j                  r|                                 |S )a  
    Run a function in the reactor from a thread, and wait for the result
    synchronously.  If the function returns a L{Deferred}, wait for its
    result and return that.

    @param reactor: The L{IReactorThreads} provider which will be used to
        schedule the function call.
    @param f: the callable to run in the reactor thread
    @type f: any callable.
    @param a: the arguments to pass to C{f}.
    @param kw: the keyword arguments to pass to C{f}.

    @return: the result of the L{Deferred} returned by C{f}, or the result
        of C{f} if it returns anything other than a L{Deferred}.

    @raise Exception: If C{f} raises a synchronous exception,
        C{blockingCallFromThread} will raise that exception.  If C{f}
        returns a L{Deferred} which fires with a L{Failure},
        C{blockingCallFromThread} will raise that failure's exception (see
        L{Failure.raiseException}).
    c                  f    t          j        gR i } |                     j                   d S r   )r   maybeDeferredaddBothput)r   ar   kwqueues    r   _callFromThreadz/blockingCallFromThread.<locals>._callFromThreadq   s=    $Q1111b11uy!!!!!r   )Queuer   get
isinstancer   FailureraiseException)r   r   r*   r+   r-   r   r,   s    ```  @r   blockingCallFromThreadr3   Y   s    , KMME" " " " " " " " ?+++YY[[F&'/**  Mr   )r   r   r$   r3   )__doc__r,   r.   r   r   twisted.pythonr   r   r   r!   r$   r3   __all__r   r   r   <module>r7      s         " " " " " " " " " " " "! ! !HS S S"  2 2 2     F  r   