https://github.com/nvbn/django-bower

Easy way to use bower with your django project
https://github.com/nvbn/django-bower

Last synced: 4 months ago
JSON representation

Easy way to use bower with your django project

• Host: GitHub
• URL: https://github.com/nvbn/django-bower
• Owner: nvbn
• Created: 2013-06-11T23:38:18.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2024-07-28T21:09:38.000Z (7 months ago)
• Last Synced: 2024-10-01T08:20:59.599Z (5 months ago)
• Language: Python
• Homepage: https://django-bower.readthedocs.io/
• Size: 187 KB
• Stars: 517
• Watchers: 18
• Forks: 73
• Open Issues: 35
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst

Awesome Lists containing this project

README

        
Django-bower

============

.. image:: https://travis-ci.org/nvbn/django-bower.png

   :alt: Build Status

   :target: https://travis-ci.org/nvbn/django-bower

.. image:: https://coveralls.io/repos/nvbn/django-bower/badge.png?branch=develop

   :alt: Coverage Status

   :target: https://coveralls.io/r/nvbn/django-bower

.. image:: https://pypip.in/v/django-bower/badge.png

   :target: https://crate.io/packages/django-bower/

.. image:: https://pypip.in/d/django-bower/badge.png

   :target: https://crate.io/packages/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:

.. code-block:: bash

    pip install django-bower

Add django-bower to `INSTALLED_APPS` in your settings:

.. code-block:: python

    'djangobower',

Add staticfinder to `STATICFILES_FINDERS`:

.. code-block:: python

    'djangobower.finders.BowerFinder',

Specify path to components root (you need to use an absolute path):

.. code-block:: python

    BOWER_COMPONENTS_ROOT = '/PROJECT_ROOT/components/'

If you need, you can manually set the path to bower:

.. code-block:: python

    BOWER_PATH = '/usr/bin/bower'

You can see an example settings file in `example project `_.

Usage

-----

Specify `BOWER_INSTALLED_APPS` in settings, like:

.. code-block:: python

    BOWER_INSTALLED_APPS = (

        'jquery#1.9',

        'underscore',

    )

Download bower packages with the management command:

.. code-block:: bash

    ./manage.py bower install

Add scripts in the template, like:

.. code-block:: html+django

    {% load static %}

    

In production you need to call `bower install` before `collectstatic`:

.. code-block:: bash

    ./manage.py bower install

    ./manage.py collectstatic

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

.. code-block:: bash

    ./manage.py bower install -- --allow-root

You can use `bower freeze` to receive `BOWER_INSTALLED_APPS` with fixed current versions:

.. code-block:: bash

    ./manage.py bower freeze

You can call bower commands like `info` and `update` with:

.. code-block:: bash

    ./manage.py bower info backbone

    ./manage.py bower update

Python 3 support

----------------

django-bower supports python 3.3+