Django integration with RQ, a Redis
based Python queuing library. Django-RQ is a
simple app that allows you to configure your queues in django's settings.py
and easily use them in your project.
Install
django-rq
:pip install django-rq
Add
django_rq
toINSTALLED_APPS
insettings.py
:INSTALLED_APPS = ( # other apps "django_rq", )
Configure your queues in django's
settings.py
(syntax based on Django's database config)RQ_QUEUES = { 'default': { 'HOST': 'localhost', 'PORT': 6379, 'DB': 0, }, 'high': { 'HOST': 'localhost', 'PORT': 6379, 'DB': 0, } 'low': { 'HOST': 'localhost', 'PORT': 6379, 'DB': 0, } }
Include
django_rq.urls
in yoururls.py
:urlpatterns += patterns('', (r'^django_rq/', include('django_rq.urls')), )
Django-RQ allows you to easily put jobs into any of the queues defined in
settings.py
. It comes with a few utility functions:
enqueue
- push a job to thedefault
queue:import django_rq django_rq.enqueue(func, foo, bar=baz)
get_queue
- accepts a single queue name argument (defaults to "default") and returns an RQQueue
instance for you to queue jobs into:import django_rq queue = django_rq.get_queue('high') queue.enqueue(func, foo, bar=baz)
get_connection
- accepts a single queue name argument (defaults to "default") and returns a connection to the queue's Redis server:import django_rq redis_conn = django_rq.get_connection('high')
django_rq provides a management command that starts a worker for every queue specified as arguments:
python manage.py rqworkers high default low
If you have RQ Scheduler installed,
you can also use the get_scheduler
function to return a Scheduler
instance for queues defined in settings.py's RQ_QUEUES
. For example:
import django_rq scheduler = django_rq.get_scheduler('default') job = scheduler.enqueue_at(datetime(2020, 10, 10), func)
You can also monitor the status of your queues from /django_rq/
. This uses some
features that's not yet available in RQ's current stable release (0.1.3) so you'll need
to install RQ's development version from https://github.com/nvie/rq to use this feature.
If you need a more sophisticated monitoring tools for RQ, you could also try rq-dashboard. provides a more comprehensive of monitoring tools.