Skip to main content

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:

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

cachebust-1.1.0.tar.gz (19.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page