Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- projekt:python_python-umgebung_env_einrichten_vorbereitungen_fuer_projekte_schaffen [2026/02/08 17:27] – torsten.roehl
+++ projekt:python_python-umgebung_env_einrichten_vorbereitungen_fuer_projekte_schaffen [2026/02/12 12:51] (aktuell) – torsten.roehl
@@ Zeile 4: / Zeile 4: @@
+//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-Kursprojekt: GPIO-App mit wachsender Architektur ======
-  * erst reines Python
+{{ :raspberry_pi:python_env.png?450 |}}
-  * dann Dauerprozess
-  * dann Web-API
-  * dann Apache davor
-  * EIN Projekt, keine Neuentwicklung
-**ENV:** gpio_projects
-**Projektpfad:** ~/devel/gpio_projects
+===== Überblick =====
+  * Voraussetzungen
+  * Umgebung (Environment) anlegen
+  * Environment managen
-===== PHASE 1 – Reines Python + GPIO =====
+===== Details =====
-==== 0) System vorbereiten ====
+==== Voraussetzungen ====
 <code bash>
 sudo apt update
@@ Zeile 32: / Zeile 30: @@
 ----
-==== 1) Projektordner anlegen ====
+==== Umgebung (Environment) anlegen ====
-<code bash>
+Um eine Umgebung zu erstellen, wird innerhalb eines Projektordners (hier Beispielsweise: ''gpio_projects'') folgender Befehl eingegeben:
-mkdir -p ~/devel/gpio_projects
-cd ~/devel/gpio_projects
-</code>
-----
-==== 2) Virtuelle Umgebung anlegen (NAME: gpio_projects) ====
 <code bash>
-python3 -m venv gpio_projects
+mkdir -p ~/devel/gpio_projects    # Projektordner anlegen
-source gpio_projects/bin/activate
+cd ~/devel/gpio_projects          # in das Projekt wechseln
+python3 -m venv gpio_env          # Environment anlegen
-pip install RPi.GPIO
 </code>
-----
-==== 3) Projektstruktur Phase 1 ====
-<code>
-gpio_projects/
- ├── gpio_hw.py
- ├── logic.py
- ├── main.py
- └── gpio_projects/        # ENV
-(gpio_env) pi@raspi88:~/devel/gpio_projects $ tree -L 1
-.
-├── gpio_env
-├── gpio_hw.py
-├── logic.py
-└── main.py
+==== 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 zu wissen, dass beim Aktivieren der komplette Pfad angegeben werden muss, während das Deaktivieren unabhängig vom aktuellen Verzeichnis funktioniert.
+=== Environment aktivieren ===
+<code bash>
+source ~/devel/gpio_projects/gpio_env/bin/activate   # kompletter Pfad nötig
 </code>
-----
+=== Environment deaktivieren ===
-==== 4) gpio_hw.py ====
-<code python  gpio_hw.py>
-import RPi.GPIO as GPIO
-PIN = 17
-GPIO.setmode(GPIO.BCM)
-GPIO.setup(PIN, GPIO.OUT)
-def on():
-    GPIO.output(PIN, GPIO.HIGH)
-def off():
-    GPIO.output(PIN, GPIO.LOW)
-def status():
-    return GPIO.input(PIN)
-def cleanup():
-    GPIO.cleanup()
-</code>
-----
-==== 5) logic.py ====
-<code python logic.py>
-import gpio_hw
-def turn_on():
-    gpio_hw.on()
-    return "on"
-def turn_off():
-    gpio_hw.off()
-    return "off"
-def get_status():
-    return "on" if gpio_hw.status() else "off"
-</code>
-----
-==== 6) main.py ====
-<code python  main.py>
-import logic
-import gpio_hw
-print("GPIO CLI gestartet (CTRL+C beendet)")
-try:
-    while True:
-        cmd = input("on / off / status > ").strip()
-        if cmd == "on":
-            print(logic.turn_on())
-        elif cmd == "off":
-            print(logic.turn_off())
-        elif cmd == "status":
-            print(logic.get_status())
-except KeyboardInterrupt:
-    pass
-finally:
-    gpio_hw.cleanup()
-</code>
-----
-==== 7) Start Phase 1 ====
 <code bash>
-cd ~/devel/gpio_projects
+deactivate        # funktioniert aus jedem Verzeichnis
-source gpio_projects/bin/activate
-python3 main.py
 </code>
-----
+=== Environment löschen ===
+Zum Löschen reicht es, den Ordner der Umgebung zu entfernen.
-===== PHASE 3 – Web später =====
 <code bash>
-pip install fastapi uvicorn
+rm -rf ~/devel/gpio_projects/gpio_env
 </code>
-----
-===== systemd später mit dieser ENV =====
-<code>
-ExecStart=/home/pi/devel/gpio_projects/gpio_projects/bin/uvicorn api:app --host 127.0.0.1 --port 8000
-</code>
-----
-===== Ergebnis =====
-  * ENV = gpio_projects
-  * Projekt = ~/devel/gpio_projects
-  * kein raspi_gpio_env mehr
-  * konsistent für alle Phasen