django-omnibus documentation¶
Django/JavaScript WebSocket Connections.
What is django-omnibus¶
django-omnibus is a Django library which helps to create websocket-based connections between a browser and a server to deliver messages.
- Some use cases could be:
- Chat systems
- Real-time stream updates
- Inter-browser communication
- file transfers
- and so on..
django-omnibus is quite extensible. The connection handler, the Tornado web application and the authenticator can be replaced by just changing the settings. See Extending django-omnibus for more detailed information.
For browser compatibility django-omnibus also supports SockJS (which provides fallbacks for older browsers).
On the client side, django-omnibus provides a library which handles the connection, authentication and channel subscription (multiple channels can be subscribed using one connection).
Contents¶
- Server
- Installation
- Configuration reference
OMNIBUS_ENDPOINT_SCHEME
OMNIBUS_SERVER_HOST
OMNIBUS_SERVER_PORT
OMNIBUS_SERVER_BASE_URL
OMNIBUS_DIRECTOR_ENABLED
OMNIBUS_FORWARDER_ENABLED
OMNIBUS_SUBSCRIBER_ADDRESS
OMNIBUS_PUBLISHER_ADDRESS
OMNIBUS_DIRECTOR_SUBSCRIBER_ADDRESS
OMNIBUS_DIRECTOR_PUBLISHER_ADDRESS
OMNIBUS_AUTHENTICATOR_FACTORY
OMNIBUS_WEBAPP_FACTORY
OMNIBUS_CONNECTION_FACTORY
- Usage (server and API)
- Extending django-omnibus
- Multi-server setups
- Internals / behind the scenes
- Client
- Contribution