Sign inDemoInstall


Package Overview
File Explorer

Install Socket

Protect your apps from supply chain attacks



Django middleware to compress responses using several algorithms.




Django Compression Middleware

This middleware implements compressed content encoding for HTTP. It is similar
to Django's ``GZipMiddleware`` (`documentation`_), but additionally supports
other compression methods. It is meant to be a drop-in replacement for Django's
``GZipMiddleware``. Its documentation — including security warnings — therefore
apply here as well.

The middleware is focussed on the task of compressing typical Django responses
such as HTML, JSON, etc.  Both normal (bulk) and streaming responses are
supported. For static file compression, have a look at other projects such as

Zstandard is a new method for compression with little client support so far.
Most browsers now support Brotli compression (check support status on `Can I
use... Brotli`_). The middleware will choose the best compression method
supported by the client as indicated in the request's ``Accept-Encoding``
header. In order of preference:

- Zstandard (zstd)
- Brotli (br)
- gzip (gzip)

Summary of the project status:

* .. image::
* .. image::
* .. image::
* .. image::

.. _`documentation`:
.. _`WhiteNoise`:
.. _`Can I use... Brotli`:

Installation and usage

The following requirements are supported and tested in all reasonable

- Python versions: 2.7, 3.5–3.11
- Interpreters: CPython and PyPy.
- Django versions: 1.11–4.1

.. code:: shell

    pip install --upgrade django-compression-middleware

To apply compression to all the views served by Django, add
``compression_middleware.middleware.CompressionMiddleware`` to the
``MIDDLEWARE`` setting:

.. code:: python

        # ...
        # ...

Remove ``GZipMiddleware`` and ``BrotliMiddleware`` if you used it before.
Consult the Django documentation on the correct `ordering of middleware`_.

.. _`ordering of middleware`:

Alternatively you can decorate views individually to serve them with

.. code:: python

    from compression_middleware.decorators import compress_page

    def index_view(request):

Note that your browser might not send the ``br`` entry in the ``Accept-Encoding``
header when you test without HTTPS (common on localhost). You can force it to
send the header, though. In Firefox, visit ``about:config`` and set
``network.http.accept-encoding`` to indicate support. Note that you might
encounter some problems on the web with such a setting (which is why Brotli is
only supported on secure connections by default).

Credits and Resources

The code and tests in this project are based on Django's ``GZipMiddleware`` and
Vašek Dohnal's ``django-brotli``. For compression, it uses the following modules
to bind to fast C modules:

- The `zstandard`_ bindings. It supports both a C module (for CPython) and CFFI
  which should be appropriate for PyPy. See the documentation for full details.
- The `Brotli`_ bindings or `brotlipy`_. The latter is preferred on PyPy since
  it is implemented using cffi. But both should work on both Python
- Python's builtin `gzip`_ module.

.. _zstandard:
.. _Brotli:
.. _brotlipy:
.. _gzip:

Further readding on Wikipedia:

- `HTTP compression <>`__
- `Zstandard <>`__
- `Brotli <>`__
- `gzip <>`__


1. Clone this repository (``git clone ...``)
2. Create a virtualenv
3. Install package dependencies: ``pip install --upgrade -r requirements_dev.txt``
4. Change some code
5. Run the tests: in the project root simply execute ``pytest``, and afterwards
   preferably ``tox`` to test the full test matrix. Consider installing as many
   supported interpreters as possible (having them in your ``PATH`` is often
6. Submit a pull request and check for any errors reported by the Continuous
   Integration service.


The MPL 2.0 License

Copyright (c) 2019-2023 `Friedel Wolff <>`_.


Did you know?

Socket installs a GitHub app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.


Related posts

SocketSocket SOC 2 Logo


  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc