Skip to main content

Radically simplified static file serving for WSGI applications

Project description

https://img.shields.io/readthedocs/whitenoise?style=for-the-badge https://img.shields.io/github/actions/workflow/status/evansd/whitenoise/main.yml.svg?branch=master&style=for-the-badge https://img.shields.io/badge/Coverage-96%25-success?style=for-the-badge https://img.shields.io/pypi/v/whitenoise.svg?style=for-the-badge https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge pre-commit

Radically simplified static file serving for Python web apps

With a couple of lines of config WhiteNoise allows your web app to serve its own static files, making it a self-contained unit that can be deployed anywhere without relying on nginx, Amazon S3 or any other external service. (Especially useful on Heroku, OpenShift and other PaaS providers.)

It’s designed to work nicely with a CDN for high-traffic sites so you don’t have to sacrifice performance to benefit from simplicity.

WhiteNoise works with any WSGI-compatible app but has some special auto-configuration features for Django.

WhiteNoise takes care of best-practices for you, for instance:

  • Serving compressed content (gzip and Brotli formats, handling Accept-Encoding and Vary headers correctly)

  • Setting far-future cache headers on content which won’t change

Worried that serving static files with Python is horribly inefficient? Still think you should be using Amazon S3? Have a look at the Infrequently Asked Questions.

To get started, see the documentation.

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

whitenoise-6.8.2.tar.gz (25.9 kB view details)

Uploaded Source

Built Distribution

whitenoise-6.8.2-py3-none-any.whl (20.2 kB view details)

Uploaded Python 3

File details

Details for the file whitenoise-6.8.2.tar.gz.

File metadata

  • Download URL: whitenoise-6.8.2.tar.gz
  • Upload date:
  • Size: 25.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for whitenoise-6.8.2.tar.gz
Algorithm Hash digest
SHA256 486bd7267a375fa9650b136daaec156ac572971acc8bf99add90817a530dd1d4
MD5 3dafb52a896b1826bbe23ebc18a83819
BLAKE2b-256 6849c21ebb5b911888c349a849ec7d1ead2dffbbcc4e2be0f6af2a7dbac03393

See more details on using hashes here.

File details

Details for the file whitenoise-6.8.2-py3-none-any.whl.

File metadata

  • Download URL: whitenoise-6.8.2-py3-none-any.whl
  • Upload date:
  • Size: 20.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for whitenoise-6.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 df12dce147a043d1956d81d288c6f0044147c6d2ab9726e5772ac50fb45d2280
MD5 77c31b1dcead2cf295cfa9d0c7babe7a
BLAKE2b-256 8c3a8d22513e1942899270dcdbd47f9886309836442cd7ede4b0d00be79715f5

See more details on using hashes here.

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