pmyshev/cadasta-platform

Main repository of the Cadasta platform. Technology to help communities document their land rights around the world.

cadasta-platform

Install for development

Install:

• VirtualBox
• Vagrant
• Ansible (For Linux and Mac, install Ansible 2 via pip. For Windows(Windows isn’t supported for the control machine) go through Ansible Documentation or this Blog.)

Clone the repository to your local machine and enter that directory. After cloning it go inside to cadasta-platform directory and run below command to provision the virtual machine. Provision the VM:

vagrant up --provision

SSH into to the VM (this automatically activates the Python virtual environment):

vagrant ssh

Enter the cadasta directory and start the server:

cd cadasta
./runserver

Open http://localhost:8000/ in your local machine's browser, this will forward you to the port on the VM and you should see the front page of the platform site.

See the wiki (here and here) for detailed instructions on installation and running the platform for development.

Run tests

Within the development VM, from the /vagrant directory run:

py.test cadasta

To get coverage reports run:

py.test cadasta --cov=cadasta  --cov-report=html

This creates a HTML report under htmlcov. See pytest-cov docs for other report formats.

AWS Deployment

Do this:

vagrant box add dummy https://github.com/mitchellh/vagrant-aws/raw/master/dummy.box
vagrant plugin install vagrant-aws
...

vagrant up --provider=aws ...

Acknowledgements

Cadasta is grateful for the technical considerations and support provided by:

• BrowserStack
• Opbeat
• Travis CI