Skip to content
A caching proxy for Bower.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bowercache
test_bowercache
.bumpversion.cfg
.coveragerc
.gitignore
.travis.yml
LICENSE
MANIFEST.in
README.md
pytest.ini
setup.cfg
setup.py

README.md

Bower Cache (the Python/Django edition)

Build Status Coverage Status Requirements Status

This is a combination Bower registry/caching proxy. It can do two things:

  • act as a registry (a name to URL mapper) for remote packages.
  • act as a caching proxy for remote Bower packages.

The admin interface is available for both functionalities.

Install

We strongly suggest installing into a virtualenv, and updating pip and setuptools inside the virtualenv first.

virtualenv .
. bin/activate
pip install -U pip setuptools
pip install bower-cache

Create a site

After Bower Cache has been installed, use the bower-cache-init command to initialize a Bower Cache site. The site contains configuration and is where the packages are actually cached.

bower-cache-init /var/lib/bower-cache

The site contains a standard Django manage.py file. In order to log into the admin site, the admin user (which has been created as part of site initialization) needs a password. Set it by running

python manage.py changepassword admin

Run the services

Bower Cache requires several services to run for it to be fully functional. The commands listed expect to be run from the site directory (the directory containing manage.py).

Run Gunicorn to serve the REST interface and admin site on port 8000:

gunicorn bowercachesite.wsgi

Run a single-process Celery worker, including the scheduler (-B):

python manage.py celery worker -c 1 -B

Run a git daemon to serve the cached packages:

git daemon --export-all --base-path=<site>/cache

Admin interface

If you're using the dev server, the admin will be available at http://127.0.0.1:8000/admin by default. Open the URL and log in as the admin.

The admin interface allows managing the cached packages, including manually issuing caching tasks and setting up daily package updates.

License

Copyright © 2013 Toran Billups, Tin Tvrtković.

Licensed under the MIT License

You can’t perform that action at this time.