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.

• Django
• RQ

• Install django-rq:

  pip install django-rq

• Add django_rq to INSTALLED_APPS in settings.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,
          'PASSWORD': 'some-password',
      },
      'high': {
          'HOST': 'localhost',
          'PORT': 6379,
          'DB': 0,
      },
      'low': {
          'HOST': 'localhost',
          'PORT': 6379,
          'DB': 0,
      }
  }

• Include django_rq.urls in your urls.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 the default 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 RQ Queue 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')

• get_worker - accepts optionnal queue names and returns a new RQ Worker instance for all (or given) queues:

  import django_rq
  w = django_rq.get_worker('default', 'hight')
  w.run()

django_rq provides a management command that starts a worker for every queue specified as arguments:

python manage.py rqworker 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.

For an easier testing process, you can run a worker synchronously this way:

from django.test impor TestCase
from django_rq import get_worker

class MyTest(TestCase):
    def test_something_that_creates_jobs(self):
        ...                      # Stuff that init jobs.
        get_worker().work(True)  # Processes all jobs then stop.
        ...                      # Asserts that the job stuff is done.

• Version 0.2.2: "PASSWORD" key in RQ_QUEUES will now be used when connecting to Redis.