Scrape and parse housemate-wanted advertisements from Gumtree, and output Json. A Javascript frontend uses this to produce a nice map-based interface.

Set up virtual environment and download dependencies:

$ virtualenv venv --no-site-packages
$ source venv/bin/activate
$ pip install -r requirements.txt

This presumes you have virtualenv, otherwise install it with Pip: pip install virtualenv. To leave the virtual environment, use deactivate. Run source venv/bin/activate again to return.

Start everything:

$ python houseshares

or use Foreman: foreman start.

The default port is 5000, though if the environment specifies one it'll use that instead.

The frontend is at:

/web/index.html

Which calls the API:

/api/LOCATION/MINUTES

eg localhost:5000/api/london/5 for adverts in London listed in the last five minutes.