Last active
December 13, 2015 23:39
-
-
Save jameskeane/4993362 to your computer and use it in GitHub Desktop.
Pondering Django Server-Sent Events
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# Uses django-signals behind the scenes to throw the events around | |
# Also uses gevent.pywsgi.WSGIServer to stream the event source. | |
# Basic usage | |
from django.dispatch import Events | |
from django.contrib.auth.models import User, Group | |
# Basic support for individual users | |
user = User.objects.get(id=1) | |
user.subcribe('event:name another:event') # subscriptions are session persistent (configurable to db)? | |
user.unsubscribe('event:name') | |
user.is_online() # Is the user currently connected to an event source? | |
# Also supports django groups (you should use them) | |
admins = Group(name='admin') | |
admins.subscribe('event:name group:event') | |
admins.unsubscribe('event:name') | |
admins.online_users() # returns an array of User objects corresponding to currently online users | |
# publish will push the update to all currently connected users | |
# It is pretty intelligent since it is using signals, it will not try to send events | |
# to users not currently connected, without having to check them. | |
Events.publish('event:name', {}) | |
# Also support sending messages to _all_ currently connected users | |
Events.broadcast('to:everyone', {'data': 'set'}) |
Keep in mind that some sort of broker server will need to be used when scaling past a single server, otherwise events in one server will not propagate.
This and the previous point, will result in the development of mongodb, redis, riak, etc. drivers for SSE_BROKER.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Phase two will probably include adding support for message persistence for tracking and replays.
Also, message persistence will allow users who have lost connections to retrieve messages they missed.