Files
liederquelle/docs/README.md
2026-01-26 17:35:57 +01:00

39 lines
1.5 KiB
Markdown

# 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