Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Revision info for Django static file

Project description

Provide a context variable to retrieve the version of a Django application.

This variable is meant to change the URL of a static file, to invalidate browser cache.

Install

pip3 install dj-static-revision

Django Static Revision only supports Python 3.4+.

Usage

Add dj_static_revision.context_processors.static_revision to your context_processors list.

TEMPLATES = (
    {
        'NAME': 'jinja2',
        'BACKEND': 'django_jinja.backend.Jinja2',
        'OPTIONS': {
            'context_processors': (
                # Other context processors
                'dj_static_revision.context_processors.static_revision',
            ),

A variable REVISION will then exists in your template, you can use it to append to static file URL.

<script src="{{ static('js/app.js') }}?v={{ REVISION }}"></script>

Django Static Revision retrieves revision string from Git history. If your source code is not managed by Git, the revision info will be read from a file named .version placed next to manage.py file.

Settings

The revision string will be truncated to 10 characters. You can change that by add to Django settings:

STATIC_REVISION_STRING_LENGTH = 10

You can also change the file for Django Static Revision to read revision string from, by add this setting:

STATIC_REVISION_VERSION_FILE = '.version'

Project details


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
dj_static_revision-0.1.4-py3-none-any.whl (4.1 kB) Copy SHA256 hash SHA256 Wheel py3
dj-static-revision-0.1.4.tar.gz (2.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page