Skip to main content

Django middleware that keep request instance for every thread.

Project description

django-middleware-global-request

Django middleware that keep request instance for every thread.

Install

pip install django-middleware-global-request

Note

  • It's NOT good to use global request, you should pass the request instance from view to anywhere you want to use it.
  • If you use the global request in Model layout, it means when you call the Model method from Django Shell, you get a None request.

Usage

  1. Add django application django_middleware_global_request to INSTALLED_APPS in pro/settings.py:

    INSTALLED_APPS = [
        ...
        'django_middleware_global_request',
        ...
    ]
    
  2. Add GlobalRequestMiddleware to MIDDLEWARE in pro/settings.py:

    MIDDLEWARE = [
        ...
        'django_middleware_global_request.middleware.GlobalRequestMiddleware',
        ...
    ]
    
  3. Use get_request to get the global request instance from a function in pro/models.py:

    from django.db import models
    from django.conf import settings
    from django_middleware_global_request import get_request
    
    class Book(models.Model):
        name = models.CharField(max_length=64)
        author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.SET_NULL, null=True, blank=True)
    
        def __str__(self):
            return self.name
    
        def save(self, *args, **kwargs):
            if not self.author:
                request = get_request()
                if request:
                    self.author = request.user
            return super().save(*args, **kwargs)
    
  4. Use with GlobalRequest(xxx): pass to set the global request to a new value in NON-USER-REQUEST context, e.g. in management command context or in python manage.py shell context. Out of the with scope, the global request instance will be reset to the value when entering into the with scope.

    import djclick as click
    from django.contrib.auth import get_user_model
    from django_middleware_global_request_example.models import Book
    from django_middleware_global_request import GlobalRequest
    
    
    @click.command()
    @click.option("-n", "--number", type=int, default=10)
    def create(number):
        admin = get_user_model().objects.all()[0]
        with GlobalRequest(user=admin):
            for i in range(number):
                book = Book(name="book{idx}".format(idx=i+1))
                book.save()
                print(i, book.name, book.author.username)
    
  5. Use GlobalRequestStorage to set the global request instance for current thread context. The global request instance will all time exists until you changed it by another value.

example.py

from django.contrib.auth import get_user_model
from django_middleware_global_request_example.models import Book
from django_middleware_global_request import GlobalRequestStorage

b1 = Book(name="b1")
b1.save()
print(b1, b1.author)

admin = get_user_model().objects.get(username="admin")
GlobalRequestStorage().set_user(admin)

b2 = Book(name="b2")
b2.save()
print(b2, b2.author)

b3 = Book(name="b3")
b3.save()
print(b3, b3.author)

example result in python3 manage.py shell context

test@test django-middleware-global-request % python3.9 manage.py shell
Python 3.9.13 (main, Jun  8 2022, 15:40:49) 
Type 'copyright', 'credits' or 'license' for more information
IPython 8.3.0 -- An enhanced Interactive Python. Type '?' for help.

In [1]: import example
b1 None
b2 admin
b3 admin

Test report

Django 1.11.xx

  • Python 3.5 passed
  • Python 3.6 passed
  • Python 3.7 passed
  • Python 3.8 passed
  • Python 3.9 passed

Django 2.2.xx

  • Python 3.5 passed
  • Python 3.6 passed
  • Python 3.7 passed
  • Python 3.8 passed
  • Python 3.9 passed
  • Python 3.10 passed

Django 3.2.xx

  • Python 3.6 passed
  • Python 3.7 passed
  • Python 3.8 passed
  • Python 3.9 passed
  • Python 3.10 passed

Django 4.0.xx

  • Python 3.8 passed
  • Python 3.9 passed
  • Python 3.10 passed

Releases

v0.3.1

  • Add app_middleware_requires to module __init__.py to work with django-app-requires.

v0.3.0

  • Add GlobalRequest and GlobalRequestStorage to set the global request instance value for NON-USER-REQUEST context.

v0.2.0

  • Rename the core package from django_global_request to django_middleware_global_request so that it matches with the package name. Note: It's NOT backward compatible, all applications that using old name MUST do changes.

v0.1.2

  • Some changes.

v0.1.1

  • Some changes.

v0.1.0

  • First release.

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

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page