Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

Django User Sessions

Build Status Test Coverage PyPI

Django includes excellent built-in sessions, however all the data is hidden away into base64 encoded data. This makes it very difficult to run a query on all active sessions for a particular user. django-user-sessions fixes this and makes session objects a first class citizen like other ORM objects.

Also, have a look at the online example app, hosted by Heroku. It also contains the package django-two-factor-auth, but that application is not a dependency for this package. Also have a look at the bundled example templates and views to see how you can integrate the application into your project.

Compatible with Django 1.4, 1.5, 1.6 and 1.7 on Python 2.6, 2.7, 3.2, 3.3 and 3.4. Documentation is available at readthedocs.org.

Features

To get the list of a user’s sessions:

user.session_set.filter(expire_date__gt=now())

Or logout the user everywhere:

user.session_set.all().delete()

The user’s IP address and user agent are also stored on the session. This allows to show a list of active sessions to the user in the admin:

http://i.imgur.com/YV9Nx3f.png

And also in a custom layout:

http://i.imgur.com/d7kZtr9.png

Installation

  1. pip install django-user-sessions

  2. In INSTALLED_APPS replace 'django.contrib.sessions' with 'user_sessions'.

  3. In MIDDLEWARE_CLASSES replace 'django.contrib.sessions.middleware.SessionMiddleware' with 'user_sessions.middleware.SessionMiddleware'.

  4. Add SESSION_ENGINE = 'user_sessions.backends.db'.

  5. Add url(r'', include('user_sessions.urls', 'user_sessions')), to your urls.py.

  6. Run python manage.py syncdb (or migrate) and browse to /account/sessions/.

GeoIP

You need to setup GeoIP for the location detection to work. See the Django documentation on installing GeoIP.

Contribute

  • Fork the repository on GitHub and start hacking.

  • Run the tests.

  • Send a pull request with your changes.

  • Provide a translation using Transifex.

License

This project is licensed under the MIT license.

Metadata

Release files for django-user-sessions 1.0.0-beta1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-user-sessions 1.0.0-beta1
File Size Uploaded
django-user-sessions-1.0.0-beta1.tar.gz 16.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for django-user-sessions 1.0.0-beta1
File Interpreter ABI Platform
django_user_sessions-1.0.0_beta1-py2.py3-none-any.whl Python 2, Python 3 none any Details

Total release size: 49.9 kB

Release files / django-user-sessions-1.0.0-beta1.tar.gz

Download URL django-user-sessions-1.0.0-beta1.tar.gz
Size 16.9 kB
Tags Source
SHA-256 checksum
How to use checksums
6c8a085b6a045c0a3f30d48f7499835ed68ca949459a0df31de59ca29dba7ed7
BLAKE2b-256 checksum
How to use checksums
29c7aef8f99b46c338b94c5dcfad31408ce74ce697c55963bf8d0a15c82eeecc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / django_user_sessions-1.0.0_beta1-py2.py3-none-any.whl

Download URL django_user_sessions-1.0.0_beta1-py2.py3-none-any.whl
Size 33.0 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
7229ca3b8e73bf9abed416cb0a9d5d247447422ec19816fe8c6ad289b9b6297e
BLAKE2b-256 checksum
How to use checksums
5ada65f2e5fb10c94c2579f56bf1d6ca8e4f05ce31583875edcff7fbf86dbff2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page