Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- modul:m122:learningunits:lu08:linux_python [2024/12/10 08:37] – msuter
+++ modul:m122:learningunits:lu08:linux_python [2024/12/10 09:16] (aktuell) – [Skript ausführen] msuter
@@ Zeile 38: / Zeile 38: @@
 ===== Virtual Environment =====
+In den meisten Fällen überlassen wir es unserer IDE, das Virtual Environment zu erstellen und zu aktivieren.
+Falls wir unser Programm jedoch auf einem Server ausführen wollen, haben wir nur die Shell zur Verfügung.
+In diesem Fall müssen wir uns selber um das ''venv'' kümmern.
+===== Voraussetzung =====
+Für das erste Projekt in WSL muss zunächst ''pip'' installiert werden: ''sudo apt install python3-pip''.
+==== Projekt erstellen ====
+Ich gehe davon aus, dass ich einen Ordner mit einem Python-Projekt erstellt habe.
+Dieser kann manuell mit ''mkdir coolproject'' erstellt werden.
+Möchte ich ein Projekt von GitHub verwenden, kann ich den Ordner mit ''git clone'' erstellen.
+<code>
+git clone https://github.com/BZZ-Commons/python-template coolproject
+</code>
+Dieser Befehl klont das Projekt von GitHub in den Ordner ''coolproject''.
+==== Virtual Environment erstellen ====
+Wir verwenden das Modul ''venv'' um unser [[https://docs.python.org/3/library/venv.html|Virtual Environment]] zu erstellen.
+| ''cd coolproject'' | Wechsle in das Verzeichnis mit deinem Pythonprojekt |
+| ''python3 -m venv ./venv'' | Führe das Modul ''venv'' aus und lege fest, wo der Ordner für das Virtual Environment angelegt wird. |
+Mit ''ls -l'' kannst du prüfen, ob der Ordner ''venv'' angelegt wurde.
+<WRAP center round tip 60%>
+Je nach Quelle wird der Zielordner ''venv'' oder ''.venv'' genannt.
+Für die Funktionalität macht dies keinen Unterschied.
+In meinen Beispielen verwende ich den Ordnernamen ''venv'' (ohne Punkt am Anfang).
+</WRAP>
+==== Virtual Environment aktivieren ====
+Bevor wir das Pythonprojekt ausführen, sollten wir das Virtual Environment aktiveren.
+Dadurch stellen wir sicher, dass alle Änderungen an der Umgebung nur dieses Projekt betreffen und nicht systemweite Änderungen gemacht werden.
+<code bash>
+source venv/bin/activate
+</code>
+Anhand des Eingabeprompts erkennen wir, dass das Virtual Environment aktiviert ist:
+<code>
+(venv) user@system:
+</code>
+Um das Virtual Environment zu deaktivieren, gib den Befehl ''deactivate'' ein.
+==== Abhängigkeiten installieren ====
+In der Regel hat jedes Pythonprojekt eine Datei ''requirements.txt'' mit einer Liste der benötigten Pakete.
+Dies erleichtert die Installation der Pakete, wenn wir das Projekt von GitHub klonen.
+<WRAP center round important 60%>
+Installiere die Pakete immer in ein aktiviertes Virtual Environment.
+Andernfalls würden die Pakete systemweit installiert, was zu Konflikten zwischen verschiedenen Projekten führen kann.
+</WRAP>
+<code bash>
+(venv) user@system:~/coolproject$ pip3 install -r requirements.txt
+</code>
+==== Skript ausführen ====
+Nun können wir unsere Pythonskripte ausführen:
+<code bash>
+(venv) user@system:~/coolproject$ python3 main.py
+</code>
 ----
 {{tag>M122-LU089}}
 [[https://creativecommons.org/licenses/by-nc-sa/4.0/|{{https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png}}]] Marcel Suter