Skip to main content

Django app that offers a big red button to sign out of all other user sessions

Project description

Big Red Button

For Django

pypi pre-commit.ci status tests ci

django-bigredbutton provides a big red "End All Other Sessions" button in a list of a user's current sessions.

Rendered with a light theme:

light_bg

Rendered with a dark theme:

dark_bg

It can work with multiple session backends, and includes built-in templates for both django-qsessions and django-user-sessions, and dynamically switches between them depending on which one is identified in settings.SESSION_ENGINE.

Compatibility

  • Python: >= 3.11
  • Django: >= 4.0

Installation

  1. Install the latest version:

    pip install django-bigredbutton
    
    poetry add django-bigredbutton
    
  2. Add a session backend, like django-qsessions or django-user-sessions. You can use the optional packaging shortcuts:

    pip install 'django-bigredbutton[qsessions]'
    
    poetry add 'django-bigredbutton[qsessions]'
    
    pip install 'django-bigredbutton[user-sessions]'
    
    poetry add 'django-bigredbutton[user-sessions]'
    

    But there may be additional steps required for each session backend. Refer to the documentation for your session backend package for their installation instructions.

  3. Add bigredbutton to INSTALLED_APPS in your project's settings.py, and optionally set BIGREDBUTTON_DELETE_SUCCESS_URL_NAME to the URL name of your choice (default: list_sessions).

  4. Register bigredbutton in your projects root URLConf:

    urlpatterns = [
        ...
        path("account/sessions/", include("bigredbutton.urls")),
        ...
    ]
    

Usage

Run Django's development server and navigate to the configured root for bigredbutton. The URL in these instructions will be http://localhost:8000/account/sessions/.

You will see a list of all of your current sessions. If you have more than one session (eg: you are signed in on more than one browser or device), you will see a big red "End All Other Sessions" button. That button will sign you out of all of your other sessions.

TODO

I have intentionally kept this app very small to minimize the maintenance burden. But contributions are very welcome!

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_bigredbutton-0.3.1.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

django_bigredbutton-0.3.1-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file django_bigredbutton-0.3.1.tar.gz.

File metadata

  • Download URL: django_bigredbutton-0.3.1.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for django_bigredbutton-0.3.1.tar.gz
Algorithm Hash digest
SHA256 337e003ff95324df1d919fa1f8a1afc10cb235a595fbc90ccff36740aecc54a9
MD5 f8041aff37feeb57cac5def65630c383
BLAKE2b-256 743a767ede2986965560f0308ee52e5d81d99306c7e8f0ccf0bc408840d8696d

See more details on using hashes here.

Provenance

File details

Details for the file django_bigredbutton-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for django_bigredbutton-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3465271aa3f1f5eb92dd7f072d86da80aeff3c36455dd1632898415c5f93eedc
MD5 30b2d2434be78329a2f3f84df127a245
BLAKE2b-256 6efe6b8032119348ce9ac8922d0fa4a66b2764eacd488c0a5e55daaf227bbe96

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page