Skip to main content

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.

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-precompressed-0.0.2.tar.gz (6.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page