coalio

Application for Winner of HackDance 2014!

Contributing

Clone the repo

1. git clone [email protected]:octaflop/coalio.git
2. cd coalio

Install Virtualenvwrapper and set up

1. Install pip
2. Install virtualenvwrapper

• pip install virtualenvwrapper
• source /usr/local/bin/virtualenvwrapper.sh
• You will want to add this line to your .bashrc or .bash_profile

3. Add the apps directory to the virtualenv:

    add2virtualenv `pwd`apps 

4. Configure the virtualenv (you will need to know your virtualenv directory): eg: vim ~/.virtualenvs/coalio/bin/postactivate
5. Update the DJANGO_SETTINGS_MODULE setting to include this line: export DJANGO_SETTINGS_MODULE='coalio.settings.local'
6. Reboot your virtualenv: deactivate && workon coalio

Install dependencies

1. cd to your repo and install dependencies: pip install -r requirements/base.txt

Create a Dev DB

1. This part’s easy: ./manage.py syncdb --migrate enter a local admin username (email) and password if prompted.

Load Static-page fixtures

To load static pages (such as about; etc) you will need to load the static page fixtures:

• ./manage.py loaddata apps/pages/fixtures/pages.json

Let ‘er rip!

1. In the repo, run ./manage.py runserver
2. Open localhost:8000 in a browser.

Pushing to production

1. Email your ssh public key to faris ☺
2. Add the remote repo: git remote add production [email protected]:coalio.git
3. Now you can push master branches to the production server by using: git push production master! (Be sure to push to origin so we're all on the same page: git push origin master).
4. If you have a migration, you will need to inform a sysadmin to run a migration on the server

Pro-tips

• You can make an easy virtualenv environment starter script in your .bash_aliases (or .bash_profile) file by adding these lines:

alias coalio='cd ~/workspace/projects/coalio && workon coalio'

alias startcoalio='coalio && ./manage.py runserver'