Introduction

This is the source code to http://cv.democracyclub.org.uk/, which gathers the Curriculum Vitae of candidates for Member of Parliament of the UK.

Environment

You'll need to set these config variables in the environment:

# used for signing tokens in emails and sessions
MPCV_SECRET_KEY=somethingfairlyrandom

# set to an email address to send all emails to
MPCV_DEBUG_EMAIL=

# any setting from http://pythonhosted.org//Flask-Mail/
MPCV_MAIL_SERVER=localhost
MPCV_MAIL_USE_SSL=True/False
MPCV_MAIL_USERNAME=
MPCV_MAIL_PASSWORD=

# S3 bucket for storing CVs in
MPCV_S3_BUCKET_NAME=xxxx
MPCV_S3_ACCESS_KEY_ID=
MPCV_S3_SECRET_ACCESS_KEY=

Development

To test in development do:

./main.py

ZZ9 9ZZ is a test constituency postcode, which uses fake data without even calling MaPit.

Testing

Python unit tests

These aim to test all the Python code.

./main_tests.py

You need the S3 bucket environment variables set, even when testing. And no other environment variables (main_tests.py sets some itself).

MPCV_S3_BUCKET_NAME=xxxx
MPCV_S3_ACCESS_KEY_ID=
MPCV_S3_SECRET_ACCESS_KEY=

You can find a line coverage report in covhtml/index.html.

Casper integration tests

These test the main use paths, and any serious browser-side Javascript.

casperjs test casper_tests.js --address=http://localhost:5000/

This works with slimerjs (Gecko-based alternative to PhantomJS) if you specify --engine=slimerjs. Useful also if you're having trouble with PhantomJS.

You can add --screenshot to put images of every page in screenshots/.

Production

In production, Heroku uses the config in Procfile.