Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

precompressed is a pluggable application for Django developers who want to serve precompressed (gzipped) static files.

Project Description


precompressed is a pluggable application for Django developers who want to serve precompressed (gzipped) static files.



  1. pip install django-precompressed
  2. Add precompressed to your settings.INSTALLED_APPS before 'django.contrib.staticfiles' so that precompressed’s version of {% static %} will be utilized.
  3. Set settings.STATICFILES_STORAGE to one that suits your needs (see Storages below).
  4. Run ./ collectstatic to generate precompressed copies.
  5. Utilize {% static %} template tag when referencing static files where applicable.


All settings are optional and specified via the settings.PRECOMPRESSED_SETTINGS dictionary.

  • GZIP_PATTERNS is a tuple of file patterns that are to be gzipped. Defaults to ('*.css', '*.js')
  • DEFAULT_COMPRESS_LEVEL is a number 0-9 that specifies the default compression level. Defaults to 9.
  • accepts_gzip(request) is a function that returns True if the client supports Content-Encoding: gzip
  • get_gzipped_name(name) is a function that translates filenames and URIs to the precompressed version. Defaults to resource.ext becomes resource.gz.ext
  • should_save_gzipped_copy(path) is a function that returns True if the specified file should have a precompressed copy saved. Defaults to file matches GZIP_PATTERNS?


These storages extend Django’s builtin StaticFilesStorage to provide the described precompression behavior. If you use this you’ll probably want to configure your webserver to add the Content-Encoding: gzip header when serving precompressed files.

These storages extend [django-storages’ S3BotoStorage]( to provide described precompression behavior for files stored on [Amazon Simple Storage Service (Amazon S3)](

The Cached prefixed versions of each utilize [CachedFilesMixin]( and therefore store hashed copies of static files in addition to the precompressed versions.

Release History

This version
History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(6.9 kB) Copy SHA256 Hash SHA256
Source Feb 26, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting