asynqueue.threads.ThreadQueue(TaskQueue)
class documentation
Part of asynqueue.threads
(View In Hierarchy)
I am a TaskQueue
for
dispatching arbitrary callables to be run by a single worker thread.
Having one and just one worker thread is surprisingly useful. It lets you do synchronous processing without blocking Twisted's event loop, yet assures you that objects processed during one queued task will not be disturbed until completion of the Deferred callback chain from that task.
Method | __init__ | ThreadQueue (**kw) |
Method | deferToThread | No summary |
Inherited from TaskQueue:
Method | __len__ | Returns my "length" as the number of workers currently at my disposal. |
Method | __bool__ | I evaluate as True if I am running and have at least one
worker. |
Method | isRunning | Returns True if shutdown has not been initiated and both my
task handler and queue are running, False otherwise. |
Method | shutdown | You must call this and wait for the Deferred it returns
when you're done with me. Calls Queue.shutdown ,
among other things. |
Method | attachWorker | Registers a new provider of IWorker for working on tasks
from the queue. |
Method | detachWorker | Detaches and terminates the worker supplied or specified by its ID. |
Method | qualifyWorker | Adds the specified series to the qualifications of the supplied worker. |
Method | workers | Returns the worker object specified by ID, or None
if that worker is not employed with me. |
Method | taskDone | Processes the status/result tuple from a worker running a task. You don't need to call this directly. |
Method | newTask | Makes a new tasks.Task object from a
func-args-kw combo. You won't call this directly. |
Method | call | Queues up a function call. |
Method | update | Sets an update task from func with any supplied arguments and keywords to be run directly on all current and future workers. |
Method | _getWorkerID | Undocumented |
Runs the f-args-kw call in my dedicated worker thread, skipping past the
queue. As with a regular TaskQueue.call
,
returns a Deferred
that fires with the result and deals with
iterators.