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!

Provide a server-side means to ensure that clients always fetch assets when they are updated

Project Description

Cachebust provides a server-side means to ensure that clients always fetch assets when they are updated on the server.

Many browsers have different means of caching, some will overcache, and using the HTTP cache headers, there’s always a chance you may need to update within the lifetime of the previous scripts.

cachebust provides a means to ensure that all assets are fetched by browsers when they are updated. The way it works, is that it takes HTML (via a library or commandline tool) and modifies the asset hrefs, adding a parameter “cachebust” equal to the md5sum of the file.

When the file changes, the md5sum will change, and the browser sees this as a distinct document, and will fetch the update no matter what its caching policy.


Usage: cacheBust (options) [input]


-r or –asset-root Specify the filesystem root which should be treated as “/” for links. Default is cwd

-e or –encoding Specify the encoding to use (default, utf-8)

-q or –quiet Do not print errors to stderr when cannot cachebust an element

–help Show this message

Library Documentation

Can be found at:

Release History

History Node


History Node


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.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(16.7 kB) Copy SHA256 Hash SHA256
Source None Dec 11, 2015

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting