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.12.0.tar.gz (26.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whitenoise-6.12.0-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: whitenoise-6.12.0.tar.gz
  • Upload date:
  • Size: 26.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for whitenoise-6.12.0.tar.gz
Algorithm Hash digest
SHA256 f723ebb76a112e98816ff80fcea0a6c9b8ecde835f8ddda25df7a30a3c2db6ad
MD5 864b21f485449341ea6b7ab68fb16146
BLAKE2b-256 cb2a55b3f3a4ec326cd077c1c3defeee656b9298372a69229134d930151acd01

See more details on using hashes here.

File details

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

File metadata

  • Download URL: whitenoise-6.12.0-py3-none-any.whl
  • Upload date:
  • Size: 20.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for whitenoise-6.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fc5e8c572e33ebf24795b47b6a7da8da3c00cff2349f5b04c02f28d0cc5a3cc2
MD5 e0cb6dcaa5def630926a42d253761f7d
BLAKE2b-256 dbebd5583a11486211f3ebd4b385545ae787f32363d453c19fffd81106c9c138

See more details on using hashes here.

Supported by

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