Metadata-Version: 1.1
Name: django-websocket-redis
Version: 0.2.3
Summary: Websocket support for Django using Redis as datastore
Home-page: https://github.com/jrief/django-websocket-redis
Author: Jacob Rief
Author-email: jacob.rief@gmail.com
License: MIT
Description: django-websocket-redis
        ======================
        
        Project home: https://github.com/jrief/django-websocket-redis
        
        Detailed documentation on:
        `ReadTheDocs <http://django-websocket-redis.readthedocs.org/en/latest/>`__.
        
        Websockets for Django using Redis as message queue
        --------------------------------------------------
        
        This module implements websockets on top of Django without requiring any
        additional framework. For messaging it uses the
        `Redis <http://redis.io/>`__ datastore and in a production environment,
        it is intended to work under `uWSGI <http://projects.unbit.it/uwsgi/>`__
        and behind `NGiNX <http://nginx.com/>`__.
        
        Features
        --------
        
        -  Largely scalable for Django applications with hundreds of open
           websocket connections.
        -  Runs in a cooperative concurrency model using
           `gevent <http://www.gevent.org/>`__, thus only one thread/process is
           simultaneously required to control **all** open websockets.
        -  Full control over the main loop during development, so **Django** can
           be started as usual with ``./manage.py runserver``.
        -  No dependency to any other asynchronous event driven framework, such
           as Tornado, Twisted or Node.js.
        -  Optionally persiting messages, allowing server reboots and client
           reconnections.
        -  The only additional requirement is a running instance of **Redis**,
           which by the way is a good replacement for memcached.
        
        Build status
        ------------
        
        |Build Status|
        
        Questions
        ---------
        
        Please use the issue tracker to ask questions.
        
        License
        -------
        
        | Copyright (c) 2013 Jacob Rief
        | Licensed under the MIT license.
        
        Release History
        ---------------
        
        -  0.2.2
        -  Moved mokey patching for Redis socket into the runner. This sometimes
           caused errors when running in development mode.
        -  Added timeout to select call. This caused IOerrors when running under
           uWSGI and the websocket was idle.
        -  0.2.1 - Reverted issue #1 and dropped compatibility with Django-1.4
           since the response status must use force\_str.
        -  0.2.0 - Major API change
        -  Use WS4REDIS\_... in Django settings
        -  Persist messages, allowing server reboots and reconnecting the client
        -  Share the file descriptor for Redis for all open connections
        -  Allow to override the subscribe/publish engine
        -  0.1.2 - fixed: Can use publish to websocket without subscribing
        -  0.1.1 - instead of CLI monkey patching, explicitly patch the
           redis.connection.socket using gevent.socket
        -  0.1.0 - initial revision
        
        |Bitdeli Badge|
        
        .. |Build Status| image:: https://travis-ci.org/jrief/django-websocket-redis.png?branch=master
           :target: https://travis-ci.org/jrief/django-websocket-redis
        .. |Bitdeli Badge| image:: https://d2weczhvl823v0.cloudfront.net/jrief/django-websocket-redis/trend.png
           :target: https://bitdeli.com/free
        
Keywords: django,websocket,redis
Platform: OS Independent
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 4 - Beta
