hidalgopl/push-notifications-async

Boilerplate for asynchronous push notifications in django-rest-framework, using celery and django-push-notifications.

Push notifications boilerplate.

This is minimalistic setup for sending asynchronous push notifications in django using django-rest-framework. Components used:

• celery
• django
• django-push-notifications
• django-rest-framework
• docker-compose
• redis

How to run

If you have docker and docker-compose installed, simply go to the project main directory and type docker-compose up -d. Project is now running on port 4000 on your localhost. Go to the http://localhost:4000/notifications/test/ to send test push.

Usage

Main advantage of this setup is sending push notifications to all user's devices asynchronously. First, read the docs of django-push-notifications package to know how to register user's device. Then you can use push_to_all_devices task to push notification to all user's devices.

Example: views.py

from rest_framework.decorators import api_view
from rest_framework.response import Response

from notifications.tasks import push_to_all_devices


@api_view(['POST'])
def send_test_push(request):
    receiver_id = request.POST['receiver_id']
    message = request.POST['message']
    push_to_all_devices.delay(message, receiver_id)
    return Response(data={'info': 'Push notification sent.'})

urls.py

from django.conf.urls import include, url
from django.contrib import admin

from .views import send_test_push

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^notifications/', send_test_push, name='test-push'),
]