This project contains the source code for the mopa util. Server side code is written in python and meant to run in python 2.7 To support the project the following external libs have been used
- Flask - for REST API and back-end HTTP
- Flask-SQLAlchemy - as ORM for db access
- Schedule - for scheduled tasks
- Jinja2 - For the report templating
- xhtml2pdf - For conversion of html template to html5
- pudb - For debugging
virtualenv venv # create virtual env
source venv/bin/activate # activate virtual env
# pip install -r requirements.txt -t vendor --upgrade # install dependencies in vendor folder.
# Option above won't work because of https://github.com/pypa/pip/issues/4390
pip install -r requirements.txt --upgrade
pip install gunicorn # install gunicorn WSGI server
python manage.py test # tests
python manage.py runserver # run dev server
gunicorn wsgi # run gunicorn
sudo rm /etc/nginx/sites-enabled/default
sudo cp path-to-mopa-utils/etc/nginx.conf /etc/nginx/sites-available/mopautils # make app available on nginx
sudo ln -s /etc/nginx/sites-available/mopautils /etc/nginx/sites-enabled/mopautils # deploy nginx
sudo service nginx reload
sudo apt-get install supervisord
sudo cp path-to-mopa-utils/etc/supervisord.conf /etc/supervisor/conf.d/mopa-utils.conf
sudo service supervisor restart
cp .env.example .env
# Edit .env then put API_KEY in /etc/environment
# Nuke *.pyc files
sudo find . -name "*.pyc" -exec rm -rf {} \;
sudo find . -name \*.pyc -deleteOfficial xhtml2pdf usage guide on github
The app uses gmail in order to send emails. Gmail by default disables sending email from scripts or programs in order to fix that you need to enable that feature.
The following link shows how: Allowing less secure apps to access your account