# Testen & Entwickeln

## Installation

Wir entwickeln auf Python 3.14. Python 3.12+ funktioniert, ältere haben zumindest Probleme mit Frescobaldi, was hiermit nichts zu tun hat…

- Python installieren von [https://www.python.org/downloads/]
- `git clone ssh://git@git.notenbund.de:9922/Notenbund/liederquelle.git`
- `cd liederquelle`
- Python virtual environment (Venv) anlegen: `python3.14 -m venv .venv`
- Venv aktivieren: `. .venv/bin/activate`
- Abhängigkeiten installieren: `pip install -Ur requirements.txt`
- `cd liederquelle`
- `.env` anlegen:

  $ python manage.py shell
  >> from django.core.management.utils import get_random_secret_key
  >> with open('.env', 'w') as dotenv:
         dotenv.write('SECRET_KEY=%s' % get_random_secret_key())
  >> ^D

- Datenbank (SQLite) anlegen: `python3 manage.py makemigrations quellen; python3 manage.py migrate`
- Admin anlegen: `python3 manage.py createsuperuser`
- Server starten: `python3 manage.py runserver`
- Öffne [http://localhost:8080/admin] im Browser

Statt `python3 manage.py` müsste auch der direkte Aufruf des Skripts funktionieren, also `./manage.py`.

## Aktualisieren

- `cd liederquelle`
- `git pull`
- Venv aktivieren: `. .venv/bin/activate`
- Abhängigkeiten aktualisieren: `pip install -Ur requirements.txt`
- `cd liederquelle`
- Datenbankstruktur aktualisieren: `python3 manage.py makemigrations quellen; python3 manage.py migrate`
- Server starten: `python3 manage.py runserver`
- Öffne [http://localhost:8080/admin] im Browser