Skip to content

Latest commit

 

History

History
98 lines (69 loc) · 2.53 KB

DEVELOPMENT.md

File metadata and controls

98 lines (69 loc) · 2.53 KB

Development

Development happens in the develop branch, while the latest stable version is in the master branch.

Setup

As with Gavel, the easiest way to get started hacking on Hammer is to use Vagrant and run everything inside a virtual machine.

Please contact sampoder@calhacks.io for additional help.

Vagrant

Make sure you have Vagrant installed on your machine.

To start the VM:

vagrant up

If you need to power off the VM at any point, run:

vagrant halt

To ssh into the VM:

vagrant ssh

Note: the rest of the commands in this section are meant to be run inside the VM, not on the host machine.

The project directory gets synchronized to /hammer inside the VM. Once you're SSHed into the box, install Hammer's dependencies. You should only need to do this once, unless Hammer's dependencies change:

cd /hammer
virtualenv env
source ./env/bin/activate
pip install -r requirements.txt

Next, set up Hammer. You should only need to do this once, unless Hammer's config options change or Hammer's database schema changes:

cp config.vagrant.yaml config.yaml # set good defaults
python initialize.py

Finally, you're ready to run Hammer:

DEBUG=true python runserver.py

Now, on your local machine, you should be able to navigate to http://localhost:5000/ and see Hammer running! You should be able to go to http://localhost:5000/admin and login with the username "admin" with the password "admin".

If you'd like to enable sending emails, you'll also need to run a celery worker with:

celery -A hammer:celery worker

While developing, you should keep vagrant rsync-auto running on the host machine so that whenever you change any files, they're automatically synced over to the VM. When the app running in the VM detects changed files, it'll automatically restart (because of the debug flag).

Tips

  • While developing, it's helpful to set the environment variable DEBUG=true

  • If Hammer's database schema is changed or if the database gets messed up in any way, you can reset everything by running (in the Vagrant VM):

    sudo su postgres -c "dropdb hammer && createdb hammer"
python initialize.py

  • This project uses EditorConfig. Download a plugin for your editor!