django-js-asset

What it is and what it does

django-js-asset extends Django's forms.Media to render script, stylesheet, and JSON tags with arbitrary HTML attributes—particularly useful for Content Security Policy nonces, module types, and data attributes. It provides JS, CSS, and JSON classes that produce Django's native Script and Stylesheet objects (backported on older Django versions), ensuring proper deduplication when multiple forms and widgets contribute media to a single page. The package also handles import maps, merging them into a single script tag rendered before all other scripts so that modules can rely on them without rewriting imports.

The library is designed for Django developers who need fine-grained control over script and stylesheet rendering—especially in admin customizations, complex forms, and applications requiring CSP compliance. It bridges the gap between older Django versions and Django 5.2's native Script object support, offering a consistent API across versions. A static helper function abstracts version differences in Django's static file handling, and the Media class can merge import maps and combine assets from multiple sources (views, forms, widgets) into a single deduplicated output.

Use it for:

• Inject CSP nonces into script tags for security-conscious applications without manual template manipulation.
• Add data attributes to scripts for passing configuration from Django templates to JavaScript without global variables.
• Render import maps alongside module scripts, letting the browser resolve short module names to hashed static file URLs.
• Combine media from multiple forms and widgets while automatically deduplicating identical assets across Django versions.
• Render inline CSS and JSON blobs alongside external stylesheets and scripts in a single Media object.
• Migrate from older Django versions to 5.2 while maintaining a consistent asset API across the codebase.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Adds script, stylesheet, and JSON tags with custom attributes to Django's forms.Media, enabling CSP-compatible data injection and import map support.

Yes. The package is actively maintained, has no known vulnerabilities, and solves a real problem for Django developers who need custom script attributes or import map support. It's especially valuable if you're using CSP nonces, passing data to scripts via attributes, or managing complex form media across multiple Django versions. The low install friction and permissive license make adoption straightforward.

Install

django-js-asset on PyPI

pip install django-js-asset

uv add django-js-asset

poetry add django-js-asset

Installing django-js-asset

Before you install

Low friction: single dependency on django, wheel-only distribution, and actively maintained with a recent release. Supports modern Python versions (3.10–3.14) and Django 4.2 and later.

License in practice

BSD-3-Clause is permissive; you may use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart

pip install django-js-asset

from django_js_asset import JS, CSS, JSON
from django import forms

media = forms.Media(js=[
    JS("script.js", {"id": "my-script", "data-config": "value"}),
])

Requires Django 4.2 or later and Python 3.10 or later.

Verify before relying

• Whether the deduplication behavior across Django 5.2–6.1 (path-only matching) versus 4.2/6.2+ (path + attributes) affects your use case.
• Support status for Django versions beyond 6.2 (fact sheet mentions 'main branch' compatibility but no explicit version ceiling).

Package facts

Evidence: django_js_asset-4.0.1-py3-none-any.whl

Tags

More Software Development packages