Batter

It makes Waffles (and other tasty things)!

To develop on this project follow these steps:

1. Download the code
2. Create your working environment
3. Install dependencies
4. Create the database schema
5. Run Batter
6. Contribute changes!

Download the code

You can get the most recent copy of Batter by cloning this repository:

git clone git://github.com/wafflesfm/batter.git

which will copy all of Batter into a new folder called batter.

Create your Working Environment

First, make sure you have downloaded virtualenv. Once that's installed, create a new virtualenv inside of the batter folder:

$ cd batter
$ virtualenv --distribute venv
$ source venv/bin/activate

Your terminal prompt should now look like this:

(venv) $ 

Install Dependencies

In your terminal, type

(venv) $ pip install -r requirements/local.txt

You should see a list of packages being downloaded and installed.

Create the Database Schema

In your terminal, type

(venv) $ python batter/manage.py syncdb
(venv) $ python batter/manage.py migrate

Run Batter

In your terminal, type

(venv) $ python batter/manage.py runserver

You should now be able to open your browser to http://localhost:8000/ and use the site.

Contribute changes!

So you want to contribute to Batter, you devilishly smart and attractive person? Awesome!

First off, fork the wafflesfm/batter repository to your own github account. After you've cloned your own fork, add the wafflesfm repo as the upstream remote with

$ git remote add upstream [email protected]:wafflesfm/batter

(If you have commit access to wafflesfm/batter, you don't need to fork or add the upstream remote. The rest of this section still applies to you!)

We use git-flow for our git workflow. Debian/Ubuntu users can sudo aptitude install git-flow, and users of other operating systems can find installation instructions here.

Once you have git-flow installed, you need to set it up for your batter repository. Setting up git-flow is a one-time thing. After you clone the repository and installed git-flow, navigate to your batter project folder and run

$ git flow init

Accept all the defaults. After the setup wizard is done, your "stable" branch should be master, "development" branch should be develop, "feature" prefix should be feature, "release" prefix should be release, "hotfix" prefix should be hotfix, and "support" prefix should be support.

After this, you can use git flow to work on new features or fix existing ones. The following articles should help you understand how git-flow works.

• http://nvie.com/posts/a-successful-git-branching-model/ - the original blog post introducing the git workflow

• http://yakiloo.com/getting-started-git-flow/ - a practical introduction to using the git-flow plugin

• http://qq.is/article/git-flow-on-github - using git-flow in tandem with GitHub pull requests.