django-node-assets 0.9.16

Features

• Avoiding vendoring static assets in your repository like jQuery plugins, Bootstrap toolkit, etc

• Avoiding mess in STATIC_ROOT through exclusion node packages’ metadata and unwanted files

• Installing dependencies by Django’s management command

Installation

$ pip install django-node-assets

Configuration

Add ‘django_node_assets’ to your INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    "django_node_assets",
]

Add NodeModulesFinder to STATICFILES_FINDERS:

STATICFILES_FINDERS = [
    "django.contrib.staticfiles.finders.FileSystemFinder",
    "django.contrib.staticfiles.finders.AppDirectoriesFinder",
    "django_node_assets.finders.NodeModulesFinder",
]

Specify absolute path to the package.json file:

NODE_PACKAGE_JSON = "/var/assets/package.json"

Specify the absolute path to a directory where the npminstall management command will install assets:

NODE_MODULES_ROOT = "/var/assets/node_modules"

Override path to the node package manager executable (optional)

NODE_PACKAGE_MANAGER_EXECUTABLE = "/usr/local/bin/npm"

Override options of the node package manager install command (optional)

NODE_PACKAGE_MANAGER_INSTALL_OPTIONS = ["--dry-run"]

Defaults to –no-package-lock, –production.

Usage

Call the npminstall management command to install dependencies specified in the package.json

$ python manage.py npminstall

Use Django’s static template tag to link installed assets

{% load static %}

<link rel="stylesheet" type="text/css" href="{% static 'bootstrap/dist/css/bootstrap.min.css' %}">
<!-- Some amazing markup -->
<script src="{% static 'jquery/dist/jquery.min.js' %}"></script>
<script src="{% static 'bootstrap/dist/js/bootstrap.js' %}"></script>