django-firestore-session-engine 1.0

This is a simple Django Session Engine that uses Firestore as the database to store session data.

Django Firestore Session Engine

This is a simple Django Session Engine that uses Firestore as the database to store session data.

Instalation

pip install --index-url https://test.pypi.org/simple/ --no-deps django-firestore-session-engine

Setup & Usage

1. Add django-firestore-session-engine to the INSTALLED_APPS list in settings.

INSTALLED_APPS = [
    ...,
    'django-firestore-session-engine'
]

2. In settings, set SESSION_ENGINE to django-firestore-session-engine.engine

SESSION_ENGINE = 'django-firestore-session-engine.engine'

3. initialize a firestore collection and set it to FIRESTORE_SESSION_COL in settings.

FIRESTORE_SESSION_COL = FIRESTORE.collection("session")

Tips

Do not 'initialize' Firestore or 'import' initialized Firestore in more than one file while using it with Djnago. A good practice is to initialize firestore in the settings file and import it from there.

Acknowledgements

This Engine was made based on what is described in the Djnago documentation on How to use sessions and after some reverse-engineering of the existing session engines, especially the 'django.contrib.sessions.backends.db' and 'django.contrib.sessions.backends.file' engines.

Please send any comments and criticisms to the author here [e-mail]

Cheers!