Django Simple Task¶
django-simple-task
runs background tasks in Django 3 without requiring other services and workers. It runs them in the same event loop as your ASGI application. It is not resilient as a proper task runner such as Celery, but works for some simple tasks and has less overall overheads.
Requirements¶
django-simple-task
expect ASGI lifespan protocol to be supported by the server. Currently Daphne does not support this.
This package is tested with:
- Python 3.7, 3.8 and 3.9,
- Django 3.1 and 3.2.
Guide¶
Install the package:
pip install django-simple-task
Added it to installed apps:
# settings.py
INSTALLED_APPS = [
...
'django_simple_task'
]
Apply ASGI middleware :
# asgi.py
from django_simple_task import django_simple_task_middlware
application = django_simple_task_middlware(application)
Call a background task in Django view:
from django_simple_task import defer
def task1():
time.sleep(1)
print("task1 done")
async def task2():
await asyncio.sleep(1)
print("task2 done")
def view(requests):
defer(task1)
defer(task2)
return HttpResponse(b"My View")
It is required to run Django with ASGI server. Official Doc
Configurations¶
Concurrency level can be controlled by adding DJANGO_SIMPLE_TASK_WORKERS
to settings. Defaults to 1
.