Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Flask-CacheBuster is a lightweight Flask extension that adds a hash to the URL query parameters of each static file.

Project description


Flask-CacheBuster is a lightweight extension that adds a hash to the URL query parameters of each static file. This lets you safely declare your static resources as indefinitely cacheable because they automatically get new URLs when their contents change.


Inspired by, and an updated version of to work with python 3.+


Using pip:

pip install flask-cachebuster



from flask_cachebuster import CacheBuster

config = { 'extensions': ['.js', '.css', '.csv'], 'hash_size': 5 }

cache_buster = CacheBuster(config=config)




* extensions - file extensions to bust
* hash_size - looks something like this `/static/index.css%3Fq3` where [%3Fq3] is the hash size.

The function will now cache-bust your static files. For example, this template:

<script src="{{ url_for('static', filename='js/main.js') }}"></script>

will render like this:

<script src="/static/js/main.js?%3Fq%3Dc5b5b2fa19"></script>

Project details

Download files

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

Files for Flask-CacheBuster, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size Flask-CacheBuster-1.0.0.tar.gz (3.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page