Skip to main content

A Django based library to make django database reactive using Server Side Events .

Project description

=======
DbReact
=======

DbReact is simple but effective django app which makes any database defined within the project reactive
using SSE ( Server Side Events - no need to install anything for sse | its a http concept ).

The library provides any addition ,or deletion of objects in model ( row in rdms table ) ,in a json based protocol
( sends json structure of objects deleted and added ) to the client (Android ,Ios ,Web).

( On more Granular Level ) you can also make group of Model objects as reactive .

Quick start
-----------

1. Add middleware string in middleware list of your project (in settings.py):

MIDDLEWARE_CLASSES = [
...
'DbReactCreator.reactMiddle.reactiveMiddleware',
]

2. Import reactive decorator to views where you want to create the event pusher, and then create eventsource::

from DbReactCreator.reactDecorators import dbreact

...

@dbreact("unique_id_for_eventsource_in_string")
def pusher_function(request):
request.META['objects_to_be_reactive'] = Model.objects.all() | Model.objects.filter() ( always a list of queryset objects)
request.META['for_model'] = Model
return JsonResponse({},status=200)


3. Define a url for the view , and pass it to the client (mobile | web) .

4. As soon as client registers the url ,it starts getting json objects of the elements not present on its end.

* Format of data received by client :
{ add: [ json_serialized_queryset_object, ... ],
delete: [ json_serialized_queryset_object, ... ]
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-dbreact-0.3.tar.gz (3.5 kB view hashes)

Uploaded Source

Built Distribution

django_dbreact-0.3-py2-none-any.whl (6.5 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page