Skip to main content

A multiprocessing distributed task queue for Django

|image0| |image1| |docs| |downloads|

::

Django Q2 is a fork of Django Q. Big thanks to Ilan Steemers for starting this project. Unfortunately, development has stalled since June 2021. Django Q2 is the new updated version of Django Q, with dependencies updates, docs updates and several bug fixes. Original repository: https://github.com/Koed00/django-q

Features


-  Multiprocessing worker pool
-  Asynchronous tasks
-  Scheduled, cron and repeated tasks
-  Signed and compressed packages
-  Failure and success database or cache
-  Result hooks, groups and chains
-  Django Admin integration
-  PaaS compatible with multiple instances
-  Multi cluster monitor
-  Redis, IronMQ, SQS, MongoDB or ORM
-  Rollbar and Sentry support

Changes compared to the original Django-Q:

- Dropped support for Disque (hasn't been updated in a long time)
- Dropped Redis, Arrow and Blessed dependencies
- Updated all current dependencies
- Added tests for Django 4.x and 5.x
- Added Turkish language
- Improved admin area
- Fixed a lot of issues

See the `changelog <https://github.com/GDay/django-q2/blob/master/CHANGELOG.md>`__ for all changes.

Requirements
  • Django <https://www.djangoproject.com>__ > = 3.2
  • Django-picklefield <https://github.com/gintas/django-picklefield>__

Tested with: Python 3.8, 3.9, 3.10, 3.11 and 3.12. Works with Django 3.2.X, 4.1.X, 4.2.X and 5.0.X

Brokers

- `Redis <https://django-q2.readthedocs.org/en/latest/brokers.html#redis>`__
- `IronMQ <https://django-q2.readthedocs.org/en/latest/brokers.html#ironmq>`__
- `Amazon SQS <https://django-q2.readthedocs.org/en/latest/brokers.html#amazon-sqs>`__
- `MongoDB <https://django-q2.readthedocs.org/en/latest/brokers.html#mongodb>`__
- `Django ORM <https://django-q2.readthedocs.org/en/latest/brokers.html#django-orm>`__

Installation
  • Install the latest version with pip::

    $ pip install django-q2

  • Add django_q to your INSTALLED_APPS in your projects settings.py::

    INSTALLED_APPS = (
        # other apps
        'django_q',
    )
    
  • Run Django migrations to create the database tables::

    $ python manage.py migrate

  • Choose a message broker <https://django-q2.readthedocs.org/en/latest/brokers.html>__, configure and install the appropriate client library.

Read the full documentation at https://django-q2.readthedocs.org <https://django-q2.readthedocs.org>__

Configuration


All configuration settings are optional. e.g:

.. code:: python

    # settings.py example
    Q_CLUSTER = {
        'name': 'myproject',
        'workers': 8,
        'recycle': 500,
        'timeout': 60,
        'compress': True,
        'cpu_affinity': 1,
        'save_limit': 250,
        'queue_limit': 500,
        'label': 'Django Q',
        'redis': {
            'host': '127.0.0.1',
            'port': 6379,
            'db': 0,
        }
    }

For full configuration options, see the `configuration documentation <https://django-q2.readthedocs.org/en/latest/configure.html>`__.

Management Commands

::

For the management commands to work, you will need to install Blessed: <https://github.com/jquast/blessed>

Start a cluster with::

$ python manage.py qcluster

Monitor your clusters with::

$ python manage.py qmonitor

Monitor your clusters' memory usage with::

$ python manage.py qmemory

Check overall statistics with::

$ python manage.py qinfo

Creating Tasks


Use `async_task` from your code to quickly offload tasks:

.. code:: python

    from django_q.tasks import async_task, result

    # create the task
    async_task('math.copysign', 2, -2)

    # or with a reference
    import math.copysign

    task_id = async_task(copysign, 2, -2)

    # get the result
    task_result = result(task_id)

    # result returns None if the task has not been executed yet
    # you can wait for it
    task_result = result(task_id, 200)

    # but in most cases you will want to use a hook:

    async_task('math.modf', 2.5, hook='hooks.print_result')

    # hooks.py
    def print_result(task):
        print(task.result)

For more info see `Tasks <https://django-q2.readthedocs.org/en/latest/tasks.html>`__


Schedule
~~~~~~~~

Schedules are regular Django models. You can manage them through the
Admin page or directly from your code:

.. code:: python

    # Use the schedule function
    from django_q.tasks import schedule

    schedule('math.copysign',
             2, -2,
             hook='hooks.print_result',
             schedule_type=Schedule.DAILY)

    # Or create the object directly
    from django_q.models import Schedule

    Schedule.objects.create(func='math.copysign',
                            hook='hooks.print_result',
                            args='2,-2',
                            schedule_type=Schedule.DAILY
                            )

    # Run a task every 5 minutes, starting at 6 today
    # for 2 hours
    from datetime import datetime

    schedule('math.hypot',
             3, 4,
             schedule_type=Schedule.MINUTES,
             minutes=5,
             repeats=24,
             next_run=datetime.utcnow().replace(hour=18, minute=0))

    # Use a cron expression
    schedule('math.hypot',
             3, 4,
             schedule_type=Schedule.CRON,
             cron = '0 22 * * 1-5')

For more info check the `Schedules <https://django-q2.readthedocs.org/en/latest/schedules.html>`__ documentation.


Testing
~~~~~~~

Running tests is easy with docker compose, it will also start the necessary databases. Just run:

.. code:: bash

    docker-compose -f test-services-docker-compose.yaml run --rm django-q2 poetry run pytest

Locale
~~~~~~

Currently available in English, German, Turkish, and French.
Translation pull requests are always welcome.

Todo
~~~~

-  Better tests and coverage
-  Less dependencies?

Acknowledgements
  • Django Q was inspired by working with Django-RQ <https://github.com/ui/django-rq>__ and RQ <https://github.com/ui/django-rq>__

  • Human readable hashes by HumanHash <https://github.com/zacharyvoase/humanhash>__

  • Redditors feedback at r/django <https://www.reddit.com/r/django/>__

  • JetBrains for their Open Source Support Program <https://www.jetbrains.com/community/opensource>__

.. |image0| image:: https://github.com/GDay/django-q2/actions/workflows/test.yml/badge.svg?branche=master :target: https://github.com/GDay/django-q2/actions?query=workflow%3Atests .. |image1| image:: https://coveralls.io/repos/github/GDay/django-q2/badge.svg?branch=master :target: https://coveralls.io/github/GDay/django-q2?branch=master .. |docs| image:: https://readthedocs.org/projects/docs/badge/?version=latest :alt: Documentation Status :scale: 100 :target: https://django-q2.readthedocs.org/ .. |downloads| image:: https://img.shields.io/pypi/dm/django-q2 :target: https://img.shields.io/pypi/dm/django-q2

Metadata

Release files for fyle-djangoq2 2.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fyle-djangoq2 2.0.2
File Size Uploaded Provenance Actions
fyle_djangoq2-2.0.2.tar.gz 58.9 kB Without provenance Details for fyle_djangoq2-2.0.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for fyle-djangoq2 2.0.2
File Interpreter ABI Platform Actions
fyle_djangoq2-2.0.2-py3-none-any.whl Python 3 none any Details for fyle_djangoq2-2.0.2-py3-none-any.whl

Total release size: 135.3 kB

Release files / fyle_djangoq2-2.0.2.tar.gz

Download URL fyle_djangoq2-2.0.2.tar.gz
Size 58.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6a2a0ea478da090353ca4f11546aed3ae2f19f771b3f7938a3c7f8f2db66101d
BLAKE2b-256 checksum
How to use checksums
86a8f02ee8fc4f440d0736ce1efbf9612655e0fe2138913a477c636bc2450261
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / fyle_djangoq2-2.0.2-py3-none-any.whl

Download URL fyle_djangoq2-2.0.2-py3-none-any.whl
Size 76.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e6644c3757c4efc1b62ea48748010921c30fa9a7f10b91dbf8c728edccea45bd
BLAKE2b-256 checksum
How to use checksums
63ac98ac2835b2744e45cf9ee93660108b36257a23d325966e50d3751d2eea13
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for fyle-djangoq2 2.0.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page