Package: ambition-django-cachebuster
DJANGO 1.4+ USERS:You should probably look to use Django’s includedstatictemplate tag rather than use django-cachebuster.  Why include a 3rd party app when you can use the built-in functionality?django-cachebuster – A backwards-compatible Django 1.3+ ready set of cache-busting template tagsOverviewdjango-cachebusteris a Django app containing two template tags:staticandmedia.  Each tag will use the file last modified timestamp by default to ‘bust’ web browser file caches.staticis meant for your site’s JavaScript, CSS and standard images.mediais intended for user uploaded content like avatars, videos and other files.  CloudFront and other content delivery networks are supported.DescriptionAll of the existing file cache busting techniques seem to be Django versions 1.2.x and lower oriented - meaning they don’t support the newdjango.contrib.staticfilesparadigm.  This app addresses this functionality gap.Additionally, there are some optimizations (seeConfigurationbelow) that can be enabled to minimize file modification date disk reads.RequirementsPython 2.6 (May work with prior versions, but untested - please report)Django 1.2.x, 1.3.x (May work with prior versions, but untested - please report)InstallationCopy or symlink the ‘cachebuster’ package into your django project directory or install it by running one of the following commands:python setup.py installpip install django-cachebustereasy_install django-cachebusterNow, addcachebusterto yourINSTALLED_APPSin your project’ssettings.pymodule.Template UsageTo use these cache-busting template tags, you’ll need to load the template tag module at the top of each template with{% load cachebuster %}.  Alternatively, as these tags will most likely be used in most of a project’s templates, you can tell Django to auto-load them without the requisite{% load cachebuster %}by adding the following to yoursettings.py:from django.template.loader import add_to_builtins
add_to_builtins('cachebuster.templatetags.cachebuster'){% static filename %}attempts to use theCACHEBUSTER_UNIQUE_STRING(seeConfigurationbelow) setting to get a cached value to append to your static URLs (ie.STATIC_URL).  IfCACHEBUSTER_UNIQUE_STRINGis not set, it falls back to the last date modified of the file.  IfCACHEBUSTER_UNIQUE_STRINGis used, you can force last-date-modified behaviour by addingTrueinto the tag statement like so:{% static filename True %}.  For example<link rel="stylesheet" href="{% static css/reset.css %}" type="text/css">
<link rel="stylesheet" href="{% static css/fonts.css True %}" type="text/css">This would yield something along the lines of:<link rel="stylesheet" href="/static/css/reset.css?927f6b650afce4111514" type="text/css">
<link rel="stylesheet" href="/static/css/fonts.css?015509150311" type="text/css">{% media filename %}is similar but has slightly different behaviour, as the file content has a different origin (user uploaded content like avatars, videos, etc.) and cannot depend on any git comment hash.  This is why there is no behaviour other than the last modified date method for MEDIA_URL files.<img src='{% media uploads/uid1-avatar.jpg %}' />would result in something like this:<img src='/media/uploads/uid1-avatar.jpg?034511190510' />Configurationdjango-cachebustersupports two methods of ‘busting’.  Appending a unique string (by default, this is the last modified datetime of the file) as a query string parameter is the easy, default behaviour.  For more advanced requirements such as content distribution network (CDN, such as CloudFront) scenarios, there is also the ability to prepend the unique string.To start using it in it’s simplest form right now, see theTemplate Usagesection.  Want more fromdjango-cachebuster?  Read on.CACHEBUSTER_UNIQUE_STRING:optional; defaults to the file’s last modified timestamp.This is a simple performance optimization that minimizes accessing the file system to get a file’s last modified timestamp.  This optimization is only used for static files (not media/user-generated files) as only static files are usually version-controlled.To setCACHEBUSTER_UNIQUE_STRING, you would mostly likely use a provided ‘detector’ or write your own (please contribute new ones!).  For example, if you use Git as your source control, you can use the providedgitdetector.  It simply traverses the Django project’s path looking for the.gitfolder, and then extracts the current commit hash.  This hash is cached and used for subsequent cache-busting.  In your settings.py:from cachebuster.detectors import git
CACHEBUSTER_UNIQUE_STRING = git.unique_string(__file__)or if you wanted it to be a short busting string:from cachebuster.detectors import git
CACHEBUSTER_UNIQUE_STRING = git.unique_string(__file__)[:8]__file__must be passed in so thatdjango-cachebusteroperates in the context of the Django project’s settings.py file.  If it wasn’t passed in, django-cachebuster would only have its own context from which to grab the.gitdirectory, not that of the user’s project.  (An alternative to this is to use Python’sinspectmodule - but there are some warnings around using it.)CACHEBUSTER_PREPEND_STATIC:optional; defaults toFalse.CACHEBUSTER_PREPEND_MEDIA:optional; defaults toFalse.If CloudFront or another CDN that ignores query string parameters is used,CACHEBUSTER_PREPEND_STATICwill need to be set toTrue.  For static files, this prepends the unique string instead of appending it as a query string parameter.CACHEBUSTER_PREPEND_MEDIAdoes the same for media files.  For example, withCACHEBUSTER_PREPEND_STATICset to True, the rendered output becomes:<link rel="stylesheet" href="/static/927f6b650afce4111514/css/reset.css" type="text/css">WithCACHEBUSTER_PREPEND_STATICset to False:<link rel="stylesheet" href="/static/css/reset.css?927f6b650afce4111514" type="text/css">Using this prepending method raises a couple of development environment issues, however.  Assuming Django 1.3 or higher is used,./manage.py runserverwill automatically attempt to serve static (not media, however) files on its own without any urls.py changes; this standard method of serving does not work in this scenario.  To prevent this default Django behaviour, the development server should be started with the following command:./manage.py runserver --nostaticAlso when using the prepending method in a development environment, to support serving files from both{% static %}and{{ STATIC_URL }}(as well as{% media %} and``{{MEDIA_URL }}), Django’s defaultserveviews need to be replaced with the following in yoururls.py:if settings.DEBUG:
    urlpatterns += patterns('',
        url(r'^static/(?P<path>.*)$', 'cachebuster.views.static_serve', {'document_root': settings.STATIC_ROOT,}),
        url(r'^media/(?P<path>.*)$', 'cachebuster.views.media_serve', {'document_root': settings.MEDIA_ROOT,}),
    )This is because both the prepended and the non-prepended paths need to be tested to support the above-mentioned scenarios.TroubleshootingMy date-based cache-busting unique strings keep updating even though my assets aren’t changingAre you deploying your assets from a source control system such as Subversion or Git?  By default, those systems set the last modified date of checked-out files to their check-out dates,notthe original files’ last modified dates. To fix this on Subversion, setuse-commit-times=truein your Subversion config. In Git this is a little harder; it requires adding a Git post-checkout hook (or updating your deployment script). For more instructions on doing this, see the answers tothis question on Stack Overflow.NotesPlease feel free to send a pull request with fixes and in particular, additionaldetectorsto improve the usefulness of this app.  Maybe forsvn,hg, etc?SourceThe latest source code can always be found here:github.com/ambitioninc/django-cachebusterCreditsdjango-cachebuster is maintained byJames Addison.Licensedjango-cachebuster is Copyright (c) 2011, James Addison. It is free software, and may be redistributed under the terms specified in the LICENSE file.Questions, Comments, Concerns:Feel free to open an issue here:github.com/ambitioninc/django-cachebuster/issues