Skip to main content

Static file CDN cache buster for fast site updates.

Project description

django-cachekiller

django-cachekiller is a small add-on for Django that adds the cdnstatic template tag which adds a 'cache busting' dynamic query string appended to the file paths. This tag functions identically to the standard {% static ... %} template tag. This is designed to work with CDNs that cache by complete URI including the query string so when you push a change the CDNs are automatically refreshed without having to wait for TTLs to expire. Internally we use this with django-distill, a static site generator for Django to work with static sites with heavy caching on images behind CloudFlare, cachefly and other CDNs:

https://github.com/meeb/django-distill

Under the hood, this module just chains the request to the existing static tag to be widely compatible.

Installation

Install from pip:

$ pip install django-cachekiller

Add django_cachekiller to your INSTALLED_APPS in your settings.py:

INSTALLED_APPS = [
    # ... other apps here ...
    'django_cachekiller',
]

That's it.

Usage

Load the new module at the top of your templates:

{% load cdnstaticfiles %}

Then use the new tag in the template exactly as you would use the static tag:

{% cdnstatic 'some/image.jpg' %}

This renders as (assuming settings.STATIC_URL is set to /static/):

/static/some/image.jpg?tag=[random tag]

[random tag] is either the truncated mercurial or git commit reference if it is available, otherwise it will be the current date in YYYYMMDDHHMMSS format. If there are existing query string parameters then the tag is intelligently appended. The cdnstatic tag will not break the existing URL.

Additionally, if you need to just access the [random tag] for some other use without the automatic URL rewriting you can use the following:

<a href="/someurl.html?tag={% cdntag %}">link</a>

This can be used in conjunction with other URL wrapping tags for combatability where chaining tags is difficult, for example:

<link rel="stylesheet" href="{% sass_src 'file.scss' %}?tag={% cdntag %}">

Contributing

All properly formatted and sensible pull requests, issues and comments are welcome.

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

django-cachekiller-0.8.2.tar.gz (4.0 kB view details)

Uploaded Source

File details

Details for the file django-cachekiller-0.8.2.tar.gz.

File metadata

  • Download URL: django-cachekiller-0.8.2.tar.gz
  • Upload date:
  • Size: 4.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.4.2 requests/2.22.0 setuptools/45.2.0 requests-toolbelt/0.8.0 tqdm/4.30.0 CPython/3.8.10

File hashes

Hashes for django-cachekiller-0.8.2.tar.gz
Algorithm Hash digest
SHA256 72cdc10889424ddfe15aa5670ed27c1aa2592a9edf0b9302454d4f74080b73e0
MD5 01643cd6656b99ef1c893df4fd6b23af
BLAKE2b-256 07f06f8805a082f4cd16da17c2c27915a8db6320f17955579aa33d2e0dfc0040

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