Warning: this package is now unmantained because django is not the optimal platform for persistent connections. I strongly recommend use anything like tornado or asyncio with python3 for this purpose.
Django integration with Server-Sent Events. (http://www.html5rocks.com/en/tutorials/eventsource/basics/) (https://developer.mozilla.org/es/docs/Server-sent_events/utilizando_server_sent_events_sse)
This django application uses the module sse, simple python implementation of sse protocol.
Is very similar to Django's generic views.
django-sse exposes a generic view for implement the custom logic of the data stream.
Additionally, it exposes some helper views for simple enqueuing messages for a client,
using redis or rabbitmq(not implemented).
NOTE: it strongly recomended expose this views with gevent pywsgi server, because every connection is permanent blocking stream.
The idea is to create a stream of data to send the current timestamp every 1 second to the client:
from django_sse.views import BaseSseView
import time
class MySseStreamView(BaseSseView):
def iterator(self):
while True:
self.sse.add_message("time", str(time.time()))
yield
time.sleep(1)The iterator() method must be a generator of data stream. The view has sse object,
for more information, see sse module documentation.
The acomulated data on sse is flushed to the client every iteration (yield statement). You can flush the buffer, sometimes as you need.
django-sse currently implements a redis helper for simple enqueuing messages for push to a clients.
For use it, the first step is a url declaration:
from django.conf.urls import patterns, include, url
from django_sse.redisqueue import RedisQueueView
urlpatterns = patterns('',
url(r'^stream1/$', RedisQueueView.as_view(redis_channel="foo"), name="stream1"),
)This, on new connection is created, opens connection to redis and subscribe to a channel. On new messages received from redis, it flushes theese to client.
And the second step, your can push messages to the queue in any other normal django views with a simple api:
from django.http import HttpResponse
from django_sse.redisqueue import send_event
def someview(request):
send_event("myevent", "mydata", channel="foo")
return HttpResponse("dummy response")RedisQueueView precises of redis, put your connection params on your settings.py:
REDIS_SSEQUEUE_CONNECTION_SETTINGS = {
'location': 'localhost:6379',
'db': 0,
}Yes, you need create a subclass of RedisQueueView and overwrite the method get_redis_channel.
Example:
# urls.py
urlpatterns = patterns('',
url(r'^sse/(?P<channel>\w+)/$', MyRedisQueueView.as_view(redis_channel="foo"), name="stream1"),
)
class MyRedisQueueView(RedisQueueView):
def get_redis_channel(self):
return self.kwargs['channel'] or self.redis_channel- Flavio Curella / https://github.com/fcurella
BSD License
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent