space-event-trace

Tracing service for TU Wien Spaceteam events.

This service is a special adaption of Space Trace.

Getting started

Install Python3.8 (or higher), zbar, popper, libxml2

Install all dependencies with:

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
export FLASK_APP=space_trace FLASK_ENV=development
flask run

This launces a simple webserver which can only be accessed from the localhost.

Note: Don't use this server in production, it is insecure and low performance.

Deployment

How we deploy this app on Ubuntu.

Install the requirements with:

sudo apt -y install python3-venv python3-pip libzbar0 libxml2-dev libxmlsec1-dev libxmlsec1-openssl poppler-utils

Create a virtual env with:

python3 -m venv venv

Copy instance/config_example.toml to instance/config.toml and edit all the fields in it.

Open space-event-trace.service and edit the username and all paths to the working directory.

Start the systemd service with:

sudo cp space-event-trace.service /etc/systemd/system
sudo systemctl daemon-reload
sudo systemctl enable space-event-trace.service
sudo systemctl start space-event-trace.service

The service should now be up and running 🎉

To stop the service run:

sudo systemctl stop space-event-trace.service

To update the service to a new version (commit) run:

git pull
sudo systemctl restart space-event-trace.service

Development

• Use black to format code
• Try to follow the python style guide PEP 8