U c6{i@sdZddlmZddlZddlmZmZddlm Z ddl m Z ddl m Z ddlmZdd lmZe d Zed Zd d dddddddZddZddZddZddZddddgZdS)zY Extended thread dispatching support. For basic support see reactor threading API docs. ) annotationsN)CallableTypeVar) ParamSpec)defer)IReactorFromThreads)failure) ThreadPool_P_Rrr zCallable[_P, _R]z_P.argsz _P.kwargszdefer.Deferred[_R])reactor threadpoolfargskwargsreturncs8tddddfdd }|j||f||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. boolz_R | BaseExceptionNone)successresultrcs&|rj|nj|dSN)callFromThreadcallbackZerrback)rrdr .onResult)rZDeferredZcallInThreadWithCallback)r r rrrrrrrdeferToThreadPoolsrcOs$ddlm}t|||f||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. rr )twisted.internetr rZ getThreadPool)rrrr rrr deferToThreadDs r!cCs|D]\}}}|||qdS)z" Run a list of functions. Nr) tupleListrrrrrr _runMultipleUsr#cCsddlm}|t|dS)z Run a list of functions in the same thread. tupleList should be a list of (function, argsList, kwargsDict) tuples. rrN)r r Z callInThreadr#)r"r rrrcallMultipleInThread]s r$csDtfdd}||}t|tjr@||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}). cs"tjf}|jdSr)rZ maybeDeferredZaddBothput)rarkwqueuerr_callFromThreadsz/blockingCallFromThread.._callFromThread)Queuerget isinstancerZFailureZraiseException)r rr'r(r*rrr&rblockingCallFromThreadhs  r.)__doc__ __future__rr)r+typingrrZtyping_extensionsrr rZtwisted.internet.interfacesrZtwisted.pythonrZtwisted.python.threadpoolr r r rr!r#r$r.__all__rrrrs(      * $