GitLocker: The Coding Marketplace

Description:

djangosri 0.7.0

Django SRI

Subresource Integrity for Django.
Installation
pip install django-sri

And add sri to your INSTALLED_APPS.
Usage
Template Tags
Note: By default, integrity hashes are not output when DEBUG is True, as static files change a lot during local development. To override this, set USE_SRI to True.
django-sri is designed to primarily be used through template tags:
{% load sri %}

{% sri_static "index.js" %} 
{% sri_static "index.css" %} 

For performance, the hashes of files are caches in Django's caching framework. It will attempt to use the "sri" cache, but fall back to "default" if it doesn't exist. The cache keys are the hash of the file path in the specified algorithm in hex. Caches are stored for as long as DEFAULT_TIMEOUT is set to.
Algorithms
The SRI standard supports 3 algorithms: sha256, sha384 and sha512. By default, SHA256 is used. To override this, supply an additional algorithm argument to the sri template tag (or the specific ones):
{% load sri %}

{% sri_static "index.js" algorithm="sha512" %} 

The default algorithm can be changed by setting SRI_ALGORITHM to the required algorithm.
Additional attributes
To add additional attributes to the output tag (such as async / defer), specify them as additional arguments to the template tag:
{% load sri %}

{% sri_static "index.js" 'defer' 'async'%}
{% sri_static "index.woff2" preload as="font" %}

Just the integrity value
To retrieve just the integrity hash (the contents of the integrity attribute), you can use the {% sri_integrity_static %} tag, which supports the same arguments as the other tags.
{% load sri %}

{% sri_integrity_static "index.js" "sha512" %} 

Supported Files
For automatic tag output, the following files are supported:

.js
.css

Unknown extensions will emit a link tag with the URL as the href attribute.
sri_integrity_static is unaffected by this limitation.
API
from pathlib import Path
from sri import calculate_integrity, calculate_integrity_of_static, Algorithm

calculate_integrity(Path("/path/to/myfile.txt")) # "sha256-..."
calculate_integrity_of_static("index.js") # "sha256-..."

calculate_integrity_of_static("index.js", Algorithm.SHA512) # "sha512-..."

"Does this work with whitenoise or alike?"
Yes. django-sri outputs the static file URL in the same way the builtin static template tag does. This means the correct cachebusted URLs are output.
When using a manifest STATICFILES_STORAGE, django-sri will automatically retrieve the hashed and post-processed file as opposed to the original.