💊 capsul.org cloud compute service - python flask web application
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
forest 63a902774e more metrics tweaks 2 years ago
capsulflask more metrics tweaks 2 years ago
.gitignore starting to work on stripe 2 years ago
Pipfile add missing dep: python-dotenv 2 years ago
Pipfile.lock add missing dep: python-dotenv 2 years ago
README.md migrate to pipenv 2 years ago
setup.cfg capacity limiter and general cleanup 2 years ago
setup.py postgres automatic schema management roughly working 2 years ago



Python Flask web application for capsul.org

how to run locally

Ensure you have the pre-requisites for the psycopg2 Postgres database adapter package

sudo apt install python3-dev libpq-dev
pg_config --version

Ensure you have the wonderful pipenv python package management and virtual environment cli

sudo apt install pipenv

Create python virtual environment and install packages

# install deps
pipenv install
# load the deps into $PATH
pipenv shell

Run an instance of Postgres (I used docker for this, you can use whatever you want, point is its listening on localhost:5432)

docker run --rm -it -e POSTGRES_PASSWORD=dev -p 5432:5432 postgres

Modify the default email settings

nano capsulflask/__init__.py

Run the app

FLASK_APP=capsulflask flask run

Run the app in gunicorn locally

pip install gunicorn
.venv/bin/gunicorn --bind capsulflask:app

postgres database schema management

capsulflask has a concept of a schema version. When the application starts, it will query the database for a table named schemaversion that has one row and one column (version). If the version it finds is not equal to the desiredSchemaVersion variable set in db.py, it will run migration scripts from the schema_migrations folder one by one until the schemaversion table shows the correct version.

For example, the script named 02_up_xyz.sql should contain code that migrates the database from schema version 1 to schema version 2. Likewise, the script 02_down_xyz.sql should contain code that migrates from schema version 2 back to schema version 1.

IMPORTANT: if you need to make changes to the schema, make a NEW schema version. DO NOT EDIT the existing schema versions.

In general, for safety, schema version upgrades should not delete data. Schema version downgrades will simply throw an error and exit for now.