Hopiu/django-ddp
1
0
Fork 0
mirror of https://github.com/jazzband/django-ddp.git synced 2026-03-16 22:40:24 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Add meteor requirement note.

Browse source 
Reformat block text to be consistent.

Remove whitespace at ends of lines.
This commit is contained in:
Matthew Schinckel 2016-01-05 22:13:26 +10:30
parent 5dba5ce143
commit b19bceb767
1 changed files with 29 additions and 15 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
README.rst
View file

@ -2,13 +2,20 @@
Django DDP
==========
`Django DDP`_ is a Django_/PostgreSQL_ implementation of the Meteor DDP server, allowing Meteor_ to subscribe to changes on Django_ models. Released under the MIT license.
`Django DDP`_ is a Django_/PostgreSQL_ implementation of the Meteor DDP
server, allowing Meteor_ to subscribe to changes on Django_ models.
Released under the MIT license.
Requirements
------------
You must be using PostgreSQL_ with psycopg2_ in your Django_ project for django-ddp to work. There is no requirement on any asynchronous framework such as Reddis or crossbar.io as they are simply not needed given the asynchronous support provided by PostgreSQL_ with psycopg2_.
You must be using PostgreSQL_ with psycopg2_ in your Django_ project
for django-ddp to work. There is no requirement on any asynchronous
framework such as Redis or crossbar.io as they are simply not needed
given the asynchronous support provided by PostgreSQL_ with psycopg2_.
Since the test suite includes an example Meteor_ project, running that
requires that Meteor_ is installed (and `meteor` is in your `PATH`).
Installation
------------
@ -19,7 +26,8 @@ Install the latest release from pypi (recommended):
pip install django-ddp
Clone and use development version direct from GitHub to test pre-release code (no GitHub account required):
Clone and use development version direct from GitHub to test pre-release
code (no GitHub account required):
.. code:: sh
@ -43,9 +51,15 @@ Overview and getting started
Scalability
-----------
All database queries to support DDP events are done once by the server instance that has made changes via the Django ORM. Django DDP multiplexes messages for active subscriptions, broadcasting an aggregated change message on channels specific to each Django model that has been published.
All database queries to support DDP events are done once by the server
instance that has made changes via the Django ORM. Django DDP multiplexes
messages for active subscriptions, broadcasting an aggregated change
message on channels specific to each Django model that has been published.
Peer servers subscribe to aggregate broadcast events which are de-multiplexed and dispatched to individual client connections. No additional database queries are required for de-multiplexing or dispatch by peer servers.
Peer servers subscribe to aggregate broadcast events which are
de-multiplexed and dispatched to individual client connections.
No additional database queries are required for de-multiplexing
or dispatch by peer servers.
Limitations