README.rst

Batucada

Batucada is a ground up rewrite of drumbeat.org in Django.

Installation

To install Batucada, you must clone the repository: :

git clone git://github.com/paulosman/batucada.git

To get started, you'll need to make sure that virtualenv and pip are installed. :

sudo easy_install virtualenv
sudo easy_install pip

I recommend using virtualenvwrapper to manage your virtual environments. Follow the installation instructions. Once installed, create your virtual environment for batucada and install the dependencies :

cd batucada
mkvirtualenv batucada 
workon batucada
pip install -r requirements/compiled.txt
pip install -r requirements/prod.txt

If you are doing an update, you might find it helps to delete pyc files: :

find . -name "*.pyc" | xargs rm

You should create a settings_local.py. Most people will be able to get away with the template provided. :

cp settings_local.dist.py settings_local.py

Next, sync the database and run migrations. :

python manage.py syncdb --noinput 

There's a problem with real databases (read: not sqlite) where south migrations are run in an order that violates foreign key constraints. See Bug # 623612 for details. Until that is fixed, you're best off running migrations in this order. :

python manage.py migrate projects
python manage.py migrate users
python manage.py migrate activity
python manage.py migrate statuses
python manage.py migrate links
python manage.py migrate dashboard
python manage.py migrate relationships

What a pain!

Finally, start the development server to take it for a spin. :

python manage.py runserver 

Get Involved

To help out with batucada, join the Drumbeat mailing list and introduce yourself. We're currently looking for help from Django / Python and front-end (HTML, CSS, Javascript) developers.