/www.freedomsponsors.org

The FreedomSponsors web application

Primary LanguagePythonGNU Affero General Public License v3.0AGPL-3.0

Build Status

FreedomSponsors is a Django web application.

FS is made by, and for developers. If you'd like to help (bug reports, suggestions, or even code), you are more than welcome. Please take a look at the open issues.

Running

Instructions to run application locally:

  1. Clone repo.
git clone git://github.com/freedomsponsors/www.freedomsponsors.org.git
  1. Create a frespo database on postgres (default username and password is frespo).

2.1 Install dependencies.

```bash
sudo pip install -r requirements.txt
```

Depending on your environment, psycopg2 installation with pip might fail.
If that's your case, you might also wanna try.

```bash
sudo apt-get install python-psycopg2
```
  1. Configure settings.
mv frespo/env_settings.py_template frespo/env_settings.py
nano frespo/env_settings.py # edit according to your environment
  1. Create database objects.
cd www.freedomsponsors.org/djangoproject
./manage.py syncdb
./migrate.sh
  1. Populate with some initial data.
./manage.py loadFeedbackData
./manage.py loadProjects
  1. Run!
./manage.py runserver # and visit http://localhost:8000

If you find that the steps above are not actually accurate, please open a new issue to let us know!

You should also verify if you can run all the automatic tests successfully. You will need to install Splinter (a Selenium wrapper), and you will also need need to create two test gmail accounts (and then specify username and password in your env_settings.py file).

To run unit tests, please refer to the Testing wiki page.

Also, there is a fully-functional test-environment at http://ambtest.freedomsponsors.org. Feel free to use it as you like (might be useful when reading the code!). We provide no guarantee about the data on it though!

Licensing

This software is licensed under the AFFERO GENERAL PUBLIC LICENSE