Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- projekt:python_python-umgebung_env_einrichten_vorbereitungen_fuer_projekte_schaffen [2026/02/08 17:26] – torsten.roehl
+++ projekt:python_python-umgebung_env_einrichten_vorbereitungen_fuer_projekte_schaffen [2026/02/22 18:30] (aktuell) – torsten.roehl
@@ Zeile 2: / Zeile 2: @@
 [[python| ☚ zurück]]
+//Ein **Python-Environment** (**virtuelle Umgebung**) dient dazu, Projekte voneinander zu trennen. Abhängigkeiten und Bibliotheken werden projektbezogen installiert, ohne das globale System zu verändern. Dadurch lassen sich unterschiedliche Projekte mit verschiedenen Paketversionen parallel betreiben und reproduzierbar aufsetzen. \\
+**Dies ist stabiler und professioneller als ohne Umgebung zu arbeiten, da durch Fehlkonfigurationen eventuell das Python-System unbrauchbar gemacht werden könnte.**//
+{{ :raspberry_pi:python_env.png?450 |}}
+===== Überblick =====
+  * Voraussetzungen
+  * Umgebung (Environment) anlegen
+  * Environment managen
+===== Details =====
+==== Voraussetzungen ====
+<code bash>
+sudo apt update
+sudo apt install -y python3 python3-pip python3-venv
+</code>
+----
+==== Umgebung (Environment) anlegen ====
+Um eine Umgebung zu erstellen, wird innerhalb eines Projektordners (hier beispielsweise: ''mein_projekt'') folgender Befehl eingegeben:
+<code bash>
+mkdir -p ~/devel/projects/mein_projekt   # Projektordner anlegen
+cd ~/devel/projects/mein_projekt         # in das Projekt wechseln
+python3 -m venv mein_projekt_env         # Environment anlegen
+</code>
+==== Environment managen ====
+Nach dem Anlegen einer Umgebung muss diese aktiviert werden, um benutzt werden zu können (dies erkennt man am Prompt). Wichtig ist außerdem, dass beim Aktivieren der korrekte Pfad zur Umgebung angegeben werden muss, während das Deaktivieren unabhängig vom aktuellen Verzeichnis funktioniert.
+=== Environment aktivieren ===
+<code bash>
+# Pfad zur venv angeben
+source ~/devel/projects/mein_projekt/mein_projekt_env/bin/activate
+</code>
+=== Environment deaktivieren ===
+<code bash>
+deactivate        # funktioniert aus jedem Verzeichnis
+</code>
+=== Environment löschen ===
+Zum Löschen reicht es, den Ordner der Umgebung zu entfernen.
+<code bash>
+rm -rf ~/devel/projects/mein_projekt/mein_projekt_env
+</code>
+===== Anhang =====
+++++ ENV |
+<code | readme.txt>
+# [python env]
+## env anlegen
+cd ~/devel/projects/mein_projekt  # in den Projektordner wechseln
+python3 -m venv mein_projekt_env  # venv erstellen
+## aktivieren                     - absolute Pfadangabe zur venv
+source ~/devel/projects/mein_projekt/mein_projekt_env/bin/activate
+## deaktivieren
+deactivate                       # venv verlassen
+## löschen
+cd ~/devel/projects/mein_projekt # in den Projektordner wechseln
+rm -rf mein_projekt_env          # venv-Ordner entfernen
+</code>
+++++
+++++ Verwendete Pakete |
+<code bash Liste>
+(course_env) pi@raspi88:~ $ pip list --not-required | grep -v pip
+Package    Version
+---------- -------
+fastapi    0.129.0
+matplotlib 3.10.8
+RPi.GPIO   0.7.1
+uvicorn    0.41.0
+(course_env) pi@raspi88:~ $
+</code>
+<code bash Quick Install>
+pip install fastapi
+pip install matplotlib
+pip install RPi.GPIO
+pip install uvicorn
+</code>
+++++