Metadata-Version: 2.4
Name: django-redis-sessions
Version: 0.6.2
Summary: Redis Session Backend For Django
Home-page: http://github.com/martinrusev/django-redis-sessions
Author: Martin Rusev
Author-email: martin@amon.cx
License: BSD
Keywords: django,sessions,
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Django
Classifier: Environment :: Web Environment
License-File: LICENSE.txt
Requires-Dist: redis>=2.4.10
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

django-redis-sessions
=====================

Redis database backend for your sessions

|Build Status|

-  `Installation`_
-  `Available Settings`_
-  `Changelog`_

Installation
============

-  Run ``pip install django-redis-sessions`` or alternatively download
   the tarball and run ``python setup.py install``,

For Django < 1.4 run ``pip install django-redis-sessions==0.3``

-  Set ``redis_sessions.session`` as your session engine, like so:

.. code:: python

    SESSION_ENGINE = 'redis_sessions.session'

Available Settings
==================

.. code:: python

    SESSION_REDIS = {
        'host': 'localhost',
        'port': 6379,
        'db': 0,
        'password': 'password',
        'prefix': 'session',
        'socket_timeout': 1,
        'retry_on_timeout': False
        }

If you prefer domain socket connection, you can just add this line
instead of HOST and PORT.

.. code:: python

    SESSION_REDIS = {
        'unix_domain_socket_path': '/var/run/redis/redis.sock',
        'db': 0,
        'password': 'password',
        'prefix': 'session',
        'socket_timeout': 1,
        'retry_on_timeout': False
    }

Redis Sentinel
~~~~~~~~~~~~~~

.. code:: python

    SESSION_REDIS_SENTINEL_LIST = [(host, port), (host, port), (host, port)]
    SESSION_REDIS_SENTINEL_MASTER_ALIAS = 'sentinel-master'

Redis Pool (Horizontal partitioning)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Splits sessions between Redis instances based on the session key. You
can configure the connection type for each Redis instance in the pool
(host/port, unix socket, redis url).


.. code:: python

    SESSION_REDIS = {
        'prefix': 'session',
        'socket_timeout': 1
        'retry_on_timeout': False,
        'pool': [{
            'host': 'localhost3',
            'port': 6379,
            'db': 0,
            'password': None,
            'unix_domain_socket_path': None,
            'url': None,
            'weight': 1
        },
        {
            'host': 'localhost2',
            'port': 6379,
            'db': 0,
            'password': None,
            'unix_domain_socket_path': None,
            'url': None,
            'weight': 1
        },
        {
            'host': 'localhost1',
            'port': 6379,
            'db': 0,
            'password': None,
            'unix_domain_socket_path': None,
            'url': None,
            'weight': 1
        }]
    }


Tests
=====

.. code:: bash

    $ pip install -r dev_requirements.txt
    # Make sure you have redis running on localhost:6379
    $ nosetests -v

`Changelog <https://github.com/martinrusev/django-redis-sessions/blob/master/CHANGELOG.md>`__
=============================================================================================

.. _Installation: #installation
.. _Available Settings: #available-settings
.. _Changelog: #changelog

.. |Build Status| image:: https://travis-ci.org/martinrusev/django-redis-sessions.svg?branch=master
   :target: https://travis-ci.org/martinrusev/django-redis-sessions
