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

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for whitenoise-6.9.0.tar.gz
Algorithm Hash digest
SHA256 8c4a7c9d384694990c26f3047e118c691557481d624f069b7f7752a2f735d609
MD5 0341c669420de0975fce0278dc1471fe
BLAKE2b-256 b9cfc15c2f21aee6b22a9f6fc9be3f7e477e2442ec22848273db7f4eb73d6162

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for whitenoise-6.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c8a489049b7ee9889617bb4c274a153f3d979e8f51d2efd0f5b403caf41c57df
MD5 4f6dd8291bd538800c42c8fff29f9578
BLAKE2b-256 64b22ce9263149fbde9701d352bda24ea1362c154e196d2fda2201f18fc585d7

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 Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page