Haldis is your friendly neighbourhood servant. He exists so lazy fucks like you and me don't need to keep tabs of who is ordering what from where. Start an order and let people add items with a simple mouse-click! No more calculating prices and making lists! Be lazier today!
From the root of the project, run:
docker compose up
This uses the config.docker.py
file as the config.
There is a special script to get started with the project. Just run it in the root of the project. Note: this script might require you to install a certain python version, you can do this using your favorite tool e.g. pyenv
./first-setup.sh
This will create a virtual environment, install the necessary dependencies and will give you the option to seed the database.
If you are using a database other then sqlite you will first need to configure the correct URI to the database in the generated 'config.py' file. Afterwards upgrade the database to the latest version using
cd app
flask db upgrade
You can now still seed the database by running, note that you might want to put your name in the HALDIS_ADMINS
in app/config.py
./populate-db.sh
in the root folder of the project.
Activate the virtual environment using
source venv/bin/activate
Finally run the webserver with
`flask run --port=8000 --debug`
Make sure to use localhost instead of 127.0.0.1 if you want to be able to login.
- Update models located in 'app/models.py'
- Run
flask db migrate
to create a new migration. - Apply the changes to the database using
flask db upgrade
- Add new dependency to the
requirements.in
file - Run
pip-compile
to freeze the dependency into therequirements.txt
file together with its own deps - Run
pip-sync
to download frozen deps
Run pip-compile --upgrade
For more information about managing the dependencies see jazzband/pip-tools: A set of tools to keep your pinned Python dependencies fresh.
No module named '_sqlite3'
-> install libsqlite3-dev
or equivalent
Error: Failed to find Flask application or factory in module 'app'. Use 'app:name' to specify one.
-> cd app
To prepare the application in a production environment, follow the same steps as for Local setup up to and including ./populate-db.sh
.
Set DEBUG to False in app/config.py
.
See Flask's deployment documentation.
Set the server's Python interpreter to /path/to/haldis/venv/bin/python
. Doing source venv/bin/activate
is not necessary when that binary is used.