Skip to main content

Django middleware that keep request instance for every thread.

Project description


Django middleware that keep request instance for every thread.


pip install django-middleware-global-request


  • 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.


  1. Add django application django_middleware_global_request to INSTALLED_APPS in pro/

  2. Add GlobalRequestMiddleware to MIDDLEWARE in pro/

  3. Use get_request to get the global request instance from a function in pro/

    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):
        def save(self, *args, **kwargs):
            if not
                request = get_request()
                if request:
           = 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 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.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))
  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.

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")

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

b2 = Book(name="b2")

b3 = Book(name="b3")

example result in python3 shell context

test@test django-middleware-global-request % python3.9 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 Passed

  • python27:~=django1.11.29
  • python34:~=django1.11.29
  • python34:~=django2.0.13
  • python35:~=django1.11.29
  • python35:~=django2.0.13
  • python35:~=django2.1.15
  • python35:~=django2.2.28
  • python36:~=django2.0.13
  • python36:~=django2.1.15
  • python36:~=django2.2.28
  • python36:~=django3.0.14
  • python36:~=django3.1.14
  • python36:~=django3.2.21
  • python37:~=django2.0.13
  • python37:~=django2.1.15
  • python37:~=django2.2.28
  • python37:~=django3.0.14
  • python37:~=django3.1.14
  • python37:~=django3.2.21
  • python38:~=django2.0.13
  • python38:~=django2.1.15
  • python38:~=django2.2.28
  • python38:~=django3.0.14
  • python38:~=django3.1.14
  • python38:~=django3.2.21
  • python38:~=django4.0.10
  • python38:~=django4.1.11
  • python38:~=django4.2.5
  • python39:~=django2.0.13
  • python39:~=django2.1.15
  • python39:~=django2.2.28
  • python39:~=django3.0.14
  • python39:~=django3.1.14
  • python39:~=django3.2.21
  • python39:~=django4.0.10
  • python39:~=django4.1.11
  • python39:~=django4.2.5
  • python310:~=django2.1.15
  • python310:~=django2.2.28
  • python310:~=django3.0.14
  • python310:~=django3.1.14
  • python310:~=django3.2.21
  • python310:~=django4.0.10
  • python310:~=django4.1.11
  • python310:~=django4.2.5
  • python311:~=django2.2.28
  • python311:~=django3.0.14
  • python311:~=django3.1.14
  • python311:~=django3.2.21
  • python311:~=django4.0.10
  • python311:~=django4.1.11
  • python311:~=django4.2.5



  • First release.


  • Some changes.


  • Some changes.


  • 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.


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


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


  • Doc update.


  • All unit test passed.

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-middleware-global-request-0.3.3.tar.gz (6.5 kB view hashes)

Uploaded source

Built Distribution

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