Django with Pulsar

This is a web chat application which illustrates how to run a django site with pulsar and how to include pulsar asynchronous request middleware into django. The code for this example is located in the examples.djchat module.

To run:

python pulse

If running for the first time, issue the:

python syncdb

command and create the super user. This example uses the django pulse application.

Message and data backend

By default, messages from connected (websocket) clients are synchronised via the pulsar data store which starts when the django site starts. It is possible to specify a different data store via the data-store option.For example, it is possible to use redis as an alternative data store by issuing the following start up command:

python pulse --data-store redis://

Views and Middleware

Check the settings module to see how this classes are used.

class examples.djchat.djchat.views.Chat[source]

WS handler managing the chat application.


Create the pubsub handler if not already available


Leave the chat room

on_message(websocket, msg)[source]

When a new message arrives, it publishes to all listening clients.


A new websocket connection is established.

Add it to the set of clients listening for messages.

class examples.djchat.djchat.views.middleware[source]

Django middleware for serving the Chat websocket.