Skip to content

13. Anhänge

13.1. Python installieren

Die Beispiele und die Fallstudie erfordern [Python] 3.12 oder neuer ([Django] 6.1 setzt dies voraus). Sie wurden mit Version 3.13 getestet.

Laden Sie unter [Windows] das Installationsprogramm von der Seite python.org/downloads herunter (die Schaltfläche „Download Python 3.13.x“ oder eine neuere Version). Aktivieren Sie auf der ersten Seite des Installationsprogramms das Kontrollkästchen „Add python.exe to PATH“, damit Sie [python] in jeder Konsole eingeben können, und klicken Sie dann auf „Install Now“. Das Installationsprogramm installiert auch [pip], das Modul [venv] und den Launcher [py] ([py -3.13] startet eine bestimmte Version, wenn mehrere Versionen installiert sind). Unter [Windows] 10 und 11 öffnet die Eingabe von [python] ohne installiertes Python den Microsoft Store: Dies ist eine Systemverknüpfung, die sich deaktivieren lässt (Einstellungen / Apps / Erweiterte App-Einstellungen / App-Ausführungsaliase).

Unter [macOS] verwenden Sie das Installationsprogramm von python.org oder den Paketmanager [Homebrew]: [brew install python@3.13]. Unter [Linux] ist [Python] bereits vorhanden, aber die Module [venv] und [pip] sind oft separate Pakete. Unter [Ubuntu] 24.04 (wo die Version von [Python] 3.12 ist):

sudo apt install python3 python3-venv python3-pip

Unter [macOS] und [Linux] heißen die Befehle [python3] und [pip3]; in einer aktivierten virtuellen Umgebung genügen [python] und [pip]. Überprüfen Sie die Installation in einer neuen Konsole:

python --version
python -m pip --version

Der erste Befehl sollte eine Versionsnummer größer oder gleich 3.12 anzeigen (zum Beispiel [Python 3.13.7]).

13.2. pip und virtuelle Umgebungen

[pip] ist der Bibliotheksmanager für [Python]. Er lädt Bibliotheken aus dem Repository [PyPI] (pypi.org) herunter: Bei der Installation ist eine Internetverbindung erforderlich. Wenn Sie sich hinter einem Unternehmensproxy befinden, geben Sie den Proxy über die Umgebungsvariablen [HTTP_PROXY] und [HTTPS_PROXY] oder über die Option [--proxy] von [pip] an.

Eine virtuelle Umgebung ist ein Ordner, der eine leichtgewichtige Kopie des [Python]-Interpreters und eigene Bibliotheken enthält: Jedes Projekt hat seine eigenen in den benötigten Versionen, ohne die [Python]-Installation oder andere Projekte zu beeinträchtigen. Nützliche Befehle in einem Projektordner (dem Ordner, der [requirements.txt] enthält):

1
2
3
4
5
6
7
python -m venv .venv                 # die virtuelle Umgebung erstellen (Ordner .venv)
.venv\Scripts\activate               # sie aktivieren (Windows)
source .venv/bin/activate            # sie aktivieren (Linux, macOS)
pip install -r requirements.txt      # die Bibliotheken des Projekts installieren
pip list                             # die installierten Bibliotheken
pip freeze                           # dieselbe Liste im Format requirements.txt
deactivate                           # die Umgebung verlassen

Unter [Windows] weigert sich [PowerShell] manchmal, das Aktivierungsskript auszuführen („Die Ausführung von Skripts ist auf diesem System deaktiviert“): Der Befehl [Set-ExecutionPolicy -Scope CurrentUser RemoteSigned] erlaubt dies für den aktuellen Benutzer. Sie können die Aktivierung auch umgehen, indem Sie den Interpreter der Umgebung direkt aufrufen: [.venv\Scripts\python manage.py runserver].

Der Ordner [.venv] lässt sich nicht von einem Rechner auf einen anderen kopieren (er enthält absolute Pfade und systemspezifische Programme): Er muss mit den obigen Befehlen neu erstellt werden. Deshalb ist er nicht in den Kursunterlagen enthalten. Der Ordner [examples] hat seine eigene Umgebung, die von allen 28 Beispielen gemeinsam genutzt wird; die Fallstudie hat ihre eigene.

Die Bibliothek [mysqlclient] und der [MySQL]-Treiber (Beispiel 28 und die Fallstudie) sind in C geschrieben. Unter [Windows] lädt [pip] eine vorkompilierte Version herunter: Es ist keine Aktion erforderlich. Unter [Linux] und [macOS] kompiliert [pip] sie selbst und benötigt dafür die Entwicklungsdateien von [MySQL] und einen Compiler:

1
2
3
sudo apt install python3-dev default-libmysqlclient-dev build-essential pkg-config     # Ubuntu, Debian
brew install mysql-client pkg-config                                                    # macOS
export PKG_CONFIG_PATH="$(brew --prefix)/opt/mysql-client/lib/pkgconfig"                # macOS, vor pip install

Ohne sie schlägt [pip install -r requirements.txt] bei [mysqlclient] fehl, mit einer Fehlermeldung, die auf [pkg-config] oder [mysql_config] verweist.

13.3. Visual Studio Code installieren

[Visual Studio Code] kann von code.visualstudio.com heruntergeladen werden. Fügen Sie drei Erweiterungen hinzu (Menü Ansicht / Erweiterungen):

  • Python (von Microsoft): zum Ausführen und Debuggen von [Python]-Code und zur Verwaltung virtueller Umgebungen. Sie installiert die Erweiterung Python Debugger gleich mit;
  • Pylance (von Microsoft, ebenfalls mit der Python-Erweiterung installiert): Code-Vervollständigung, Code-Navigation (auch im Code von [Django], der im Ordner [.venv] liegt), Fehlermeldungen und Prüfung von Typannotationen;
  • Django (von Baptiste Darthenay): Syntaxhervorhebung und Tastenkürzel für die [Django]-Templates ([.html]-Dateien im Ordner [templates]).

Öffnen Sie den Ordner [examples] oder den Ordner der Fallstudie (Menü Datei / Ordner öffnen) und wählen Sie dann den Interpreter der virtuellen Umgebung des Ordners aus (Befehlspalette, Strg+Umschalt+P, Python: Select Interpreter, dann der Interpreter aus [.venv]). Das integrierte Terminal (Menü Terminal / Neues Terminal) aktiviert die Umgebung dann automatisch und ermöglicht es, Anwendungen und Befehle wie [python manage.py ...] auszuführen, ohne den Editor zu verlassen.

Um eine Anwendung schrittweise auszuführen, erstellen Sie eine Debug-Konfiguration (Menü Ausführen / Konfiguration hinzufügen, dann Python Debugger und Django): Der Editor startet [manage.py runserver] unter der Kontrolle des Debuggers und hält an den in den Views gesetzten Haltepunkten an.

13.4. MySQL mit Laragon installieren

[Laragon] installiert unter [Windows] einen sofort einsatzbereiten [MySQL]-Server zusammen mit dem Administrationswerkzeug [HeidiSQL] (siehe „Laragon installieren“ in der Einleitung). Nach der Installation:

  • Die Schaltfläche „Alle starten“ startet den [MySQL]-Server auf Port 3306;
  • Der Benutzer [root] hat kein Passwort: Dies sind die Werte aus der Einstellung [DATABASES] in Beispiel 28 ([config/settings.py]) und die Variablen [DB_USER] und [DB_PASSWORD] aus der Datei [.env] in der Fallstudie;
  • Die Schaltfläche „Datenbank“ öffnet [HeidiSQL], wo der Menüpunkt Datei / SQL-Datei ausführen die Skripte [dbpersons.sql] (Beispiel 28) und [dbrdvmedecins2.sql] (Fallstudie) ausführt.

Installieren Sie unter [Linux] oder [macOS] [MySQL] oder [MariaDB] mit dem Paketmanager des Systems und führen Sie die Skripte mit dem Kommandozeilenclient [mysql] aus ([mysql -u root < database/dbrdvmedecins2.sql]). Der Treiber [mysqlclient] und die [MySQL]-Engine von [Django] funktionieren mit beiden ohne jede Konfiguration. Unter [Linux] ist das Konto [root] von [MariaDB] oft so konfiguriert, dass die Anmeldung nur über das Systemkonto [root] ([sudo mysql]) möglich ist: Für die Anwendungen wird dann ein Benutzer angelegt:

sudo mysql -e "CREATE USER 'course'@'localhost' IDENTIFIED BY 'course'; GRANT ALL ON dbpersons.* TO 'course'@'localhost'; GRANT ALL ON dbrdvmedecins2.* TO 'course'@'localhost';"

und wir geben diesen den Anwendungen vor: die Schlüssel [USER] und [PASSWORD] der Einstellung [DATABASES] bei Beispiel 28, die Zeilen [DB_USER=course] and [DB_PASSWORD=course] in der Datei [.env] bei der Fallstudie.

13.5. curl installieren

[curl] ist in [Windows] 10 und 11, [macOS] und den meisten [Linux]-Distributionen enthalten. In [PowerShell] müssen Sie [curl.exe] eingeben, nicht [curl]: In älteren Versionen von [PowerShell] ist [curl] ein Alias für einen anderen Befehl ([Invoke-WebRequest]), der andere Optionen hat. In der Eingabeaufforderung von [Windows] ([cmd]) werden die Anführungszeichen einer JSON-Zeichenkette als [\"] geschrieben (Beispiel 11), und eine URL-Zeichenkette, die [&] enthält, muss in doppelte Anführungszeichen gesetzt werden.

13.6. Das Werkzeug django-admin

[Django] installiert einen Befehl, [django-admin], der für die Arbeit mit diesem Dokument nicht erforderlich ist (die Beispiele werden einsatzbereit mitgeliefert), aber zum Anlegen eines neuen Projekts dient. Die Datei [manage.py] jedes Projekts ist eine [django-admin] -Datei, die zusätzlich die Einstellungen des Projekts kennt: Innerhalb eines Projekts geben Sie [python manage.py] statt [django-admin] ein. Die nützlichsten Befehle:

django-admin startproject config .        # ein neues Projekt, dessen Konfiguration das Paket config ist
python manage.py startapp pages           # eine neue Anwendung, der Ordner pages
python manage.py runserver 8000           # der Entwicklungsserver
python manage.py check                    # das Projekt prüfen (Einstellungen, Routen, Modelle...)
python manage.py check --deploy           # die Sicherheitseinstellungen für die Produktion prüfen
python manage.py shell                    # eine Python-Konsole, mit geladenem Django
python manage.py dbshell                  # der Datenbank-Client, mit den Einstellungen des Projekts
python manage.py inspectdb                # die Modelle einer bestehenden Datenbank schreiben (zu prüfen und zu korrigieren)
python manage.py makemessages -l fr       # die zu übersetzenden Texte sammeln (Datei .po)
python manage.py compilemessages          # die Wörterbücher kompilieren (Dateien .mo)
python manage.py collectstatic            # die statischen Dateien für die Produktion sammeln
python manage.py diffsettings             # die Einstellungen, die von den Standardwerten abweichen

Der Punkt am Ende des Befehls [startproject] legt das Projekt im aktuellen Ordner an (ohne ihn wird das Projekt in einem neuen Ordner namens [config] angelegt). Eine mit [startapp] erstellte Anwendung muss zur Einstellungsliste [INSTALLED_APPS] hinzugefügt werden. Der Befehl [inspectdb] ist ein wertvolles Werkzeug für eine bestehende Datenbank, wie die der Fallstudie: Er liest die Tabellen und erzeugt mit [managed = False] einen ersten Entwurf der Modelle; es bleibt nur noch, die Beziehungen zu benennen, die Typen auszuwählen und die Methoden hinzuzufügen. Die Befehle [makemigrations] und [migrate], die Tabellen anhand der Modelle erstellen und aktualisieren, wurden in diesem Dokument nicht verwendet: Seine Datenbanken werden durch SQL-Skripte erstellt, die mit anderen Versionen der Anwendung geteilt werden.