HEPPA: hyvin edistynyt perjantaipiirretty applikaatio. Web-app that allows approval voting (with veto), intended for selecting the Gurula friday cartoon. Started as a database application project over winter break 2018-2019.
NB: this application is not secure in any way. Any user can log in with your username.
Before voting, you need to register an account.
After registering, you can add candidates and vote on them. The electoral system is approval voting with the addition of an unrestricted veto right for everyone. Voting is not anonymous so that the veto cannot be abused.
Make sure that you have these dependencies installed on your machine:
- Python 3 and its dev packages
- Python 3 venv
- PostgreSQL and its dev packages (may also work without)
On Debian/Ubuntu
sudo apt install python3-dev python3-venv postgresql libpq-dev
Run these in the root directory to launch the app at
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
# Optional, enables translations by building the .mo files
pybabel compile -d application/translations
python3 run.pyYou can then open the app in your browser at http://127.0.0.1:5000/
Get the latest translations from the application
pybabel extract -F babel.cfg -k lazy_gettext -o messages.pot .Initialize a translation file
pybabel init -i messages.pot -d application/translations -l <language_code>
# e.g. pybabel init -i messages.pot -d application/translations -l fiEdit the translation file in translations/<language_code>/LC_MESSAGES/messages.po and translate the strings (the msgstr fields).
Compile the translation file
pybabel compile -d application/translationsGet the latest translations from the application
pybabel extract -F babel.cfg -k lazy_gettext -o messages.pot .Update the translation file
pybabel update -i messages.pot -d application/translationsEdit the translation file in translations/<language_code>/LC_MESSAGES/messages.po and translate the strings (the msgstr fields). Fields marked with #~ are obsolete and can be removed. Fields marked with fuzzy should be reviewed and the fuzzy tag removed when the translation is correct.
Compile the translation file
pybabel compile -d application/translationsInstall Docker and add your user to the docker group.
Run this command to build the docker image
docker build -t heppa .
This command will then start the application in docker
docker run --rm -p 8000:8000 heppa
You can then open the app in your browser at http://127.0.0.1:8000/
Install Docker and Docker Compose.
Define POSTGRES_PASSWORD env variable.
Run this command to start the app
docker compose up
It should now be available at http://127.0.0.1:8000/
