Metadata-Version: 2.1
Name: django-mdbsessions
Version: 0.0.2
Summary: Use MongoDB as Django session backend
Home-page: https://github.com/somatoko/django-mdbsessions
Author: somatoko
Author-email: 
License: MIT
Description: ## django-mongo-sessions
        
        Forked version from [django-mongo-sessions](https://github.com/hellysmile/django-mongo-sessions).
        
        > Explain why this fork was needed.
        
        
        ### Features
        
         - fast NoSQL Django sessions backend
         - invalidation via [TTL](http://docs.mongodb.org/manual/tutorial/expire-data/)
        
        ### Installation
        
        - Install with pip
        
        ```bash
        pip install django-mongo-sessions
        ```
        
        - Inside settings.py
        
        
        ```python
        SESSION_ENGINE = 'mongo_sessions.session'
        ```
        
        ### Available settings
        
        There is two ways to setup mongodb connection at `settings.py`.
        First, if already have mongo connection, like::
        
        ```python
        import pymongo
        from pymongo import MongoClient
        connection = MongoClient()
        MONGO_CLIENT = connection.your_database
        MONGO_SESSIONS_COLLECTION = 'mongo_sessions' # default option
        ```
        
        Second, if you need to connect to mongodb, like::
        
        ```python
        MONGO_PORT = 27017
        MONGO_HOST = 'localhost'
        MONGO_DB_NAME = 'test'
        MONGO_DB_USER = False
        MONGO_DB_PASSWORD = False
        MONGO_SESSIONS_COLLECTION = 'mongo_sessions'
        
        # all this settings are defaults, you can skip any
        ```
        
        ``expireAfterSeconds`` index value by default is ``SESSION_COOKIE_AGE``
        you can change::
        
            MONGO_SESSIONS_TTL = 60 * 60 # one hour
        
        be sure, that you know what are you doing with it, ``SESSION_COOKIE_AGE``
        will get different expiration time
        
        every time you change one of this values, ``expireAfterSeconds`` index
        will be dropped and then will be indexed with ``ensureIndex`` again,
        be careful here
        
        *it is good way to change expireAfterSeconds only by 1 running instance*
        
        ## Tests
        
        ```bash
        pip install tox
        tox
        ```
        
Keywords: django mongodb session
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Session
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
