Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/django-q2/django-q2

A multiprocessing distributed task queue for Django based on Django-Q
https://github.com/django-q2/django-q2

django task-queue

Last synced: about 2 months ago
JSON representation

A multiprocessing distributed task queue for Django based on Django-Q

Awesome Lists containing this project

README 

        
A multiprocessing distributed task queue for Django

---------------------------------------------------



|image0| |image1| |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 `__ for all changes.



Requirements

~~~~~~~~~~~~



-  `Django `__ > = 4.2

-  `Django-picklefield `__



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



Brokers

~~~~~~~

- `Redis `__

- `IronMQ `__

- `Amazon SQS `__

- `MongoDB `__

- `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 `__, configure and install the appropriate client library.



Read the full documentation at `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 `__.



Management Commands

~~~~~~~~~~~~~~~~~~~



For the management commands to work, you will need to install 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 `__



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 `__ documentation.



Development

~~~~~~~~~~~



There is an example project that you can use to develop with. Docker (compose) is being used to set everything up.

Please note that you will have to restart the django-q container when changes have been made to tasks or django-q.

You can start the example project with:



.. code:: bash



    make dev



Create a superuser with:



.. code:: bash



    make createsuperuser



Testing

~~~~~~~



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



.. code:: bash



    make test



Locale

~~~~~~



Currently available in English, German, Turkish, and French.

Translation pull requests are always welcome.



Acknowledgements

~~~~~~~~~~~~~~~~



-  Django Q was inspired by working with

   `Django-RQ `__ and

   `RQ `__

-  Human readable hashes by

   `HumanHash `__

-  Redditors feedback at `r/django `__



-  JetBrains for their `Open Source Support Program `__



.. |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

.. |downloads| image:: https://img.shields.io/pypi/dm/django-q2

   :target: https://img.shields.io/pypi/dm/django-q2