shoshincollege.org

an independent experimental school

Development

This is a standard Django application with uv.

1. Setup environment variables with:

cp .envrc.example .envrc
source .envrc

2. Create database tables with:

uv run manage.py migrate

3. Run development server with:

uv run manage.py runserver

Format and lint

Run Python formatting with:

uv run ruff format

Run Python linting with:

uv run ruff check --fix

Deploy

Every commit on branch main auto-deploys using GitHub Actions. To deploy manually:

cd ansible/
cp .envrc.example .envrc
uv run ansible-playbook playbook.yaml -v

License

Copyright Shoshin College CIC

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3.