Document how to start a worker.

This commit is contained in:
Vincent Driessen 2011-11-15 23:00:55 +01:00
parent 22f3da1832
commit 83e29ca987
1 changed files with 35 additions and 0 deletions

View File

@ -39,6 +39,41 @@ own desire. Common patterns are to name your queues after priorities (e.g.
`high`, `medium`, `low`). `high`, `medium`, `low`).
# The worker
**NOTE: You currently need to create the worker yourself, which is extremely
easy, but RQ will create a custom script soon that can be used to start
arbitrary workers without writing any code.**
Creating a worker daemon is also extremely easy. Create a file `worker.py`
with the following content:
from rq import Queue, Worker
q = Queue()
Worker(q).work_forever()
After that, start a worker instance:
python worker.py
This will wait for work on the default queue and start processing it as soon as
messages arrive.
You can even watch several queues at the same time and start processing from
them:
from rq import Queue, Worker
queues = map(Queue, ['high', 'normal', 'low'])
Worker(queues).work()
Which will keep working as long as there is work on any of the three queues,
giving precedence to the `high` queue on each cycle, and will quit when there
is no more work (contrast this to the previous worker example, which will wait
for new work when called with `Worker.work_forever()`.
# Installation # Installation
Simply use the following command to install the latest released version: Simply use the following command to install the latest released version: