atabary/django-bower

Easy way to use bower with your django project

Django-bower

Easy way to use bower with your django project.

Bower is a package manager for the web. It offers a generic, unopinionated solution to the problem of front-end package management, while exposing the package dependency model via an API that can be consumed by a more opinionated build stack. There are no system wide dependencies, no dependencies are shared between different apps, and the dependency tree is flat.

Read full documentation on read-the-docs.

Installation

Install django-bower package:

pip install django-bower

Add django-bower to INSTALLED_APPS in your settings:

'djangobower',

Add staticfinder to STATICFILES_FINDERS:

'djangobower.finders.BowerFinder',

Specifie path to components root (you need to use absolute path):

BOWER_COMPONENTS_ROOT = '/PROJECT_ROOT/components/'

If you need, you can manually set path to bower

BOWER_PATH = '/usr/bin/bower'

You can see example settings file in example project.

Usage

Specifie BOWER_INSTALLED_APPS in settings, like:

BOWER_INSTALLED_APPS = (
    'jquery#1.9',
    'underscore',
)

Download bower packages with management command:

./manage.py bower_install

Add scripts in template, like:

{% load static %}
<script type="text/javascript" src='{% static 'jquery/jquery.js' %}'></script>

In production you need to call bower_install before collectstatic:

./manage.py bower_install
./manage.py collectstatic

If you need to pass arguments to bower, like --allow-root, use:

./manage.py bower_install -- --allow-root

You can use bower_freeze to receive BOWER_INSTALLED_APPS with fixed current versions:

./manage.py bower_freeze

Python 3 support

django-bower supports python 3.3+