175 lines
4.4 KiB
Markdown
175 lines
4.4 KiB
Markdown
# MYP Platform - Requirements Verwaltung
|
|
|
|
## Übersicht
|
|
|
|
Die MYP Platform verwendet verschiedene Requirements-Dateien für unterschiedliche Umgebungen:
|
|
|
|
- `requirements.txt` - **Basis-Abhängigkeiten basierend auf tatsächlich verwendeten Imports in app.py**
|
|
- `requirements-dev.txt` - Entwicklungsabhängigkeiten (Testing, Debugging, etc.)
|
|
- `requirements-prod.txt` - Produktionsabhängigkeiten (optimiert für Performance)
|
|
|
|
## Installation
|
|
|
|
### Basis-Installation (Empfohlen)
|
|
|
|
```bash
|
|
# Nur die wirklich benötigten Abhängigkeiten installieren
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Entwicklungsumgebung
|
|
|
|
```bash
|
|
# Alle Entwicklungsabhängigkeiten installieren
|
|
pip install -r requirements-dev.txt
|
|
```
|
|
|
|
### Produktionsumgebung
|
|
|
|
```bash
|
|
# Produktionsabhängigkeiten installieren
|
|
pip install -r requirements-prod.txt
|
|
```
|
|
|
|
## Aktualisierte Requirements (Januar 2025)
|
|
|
|
### Basis-Requirements (requirements.txt)
|
|
**Basierend auf tatsächlich verwendeten Imports in app.py:**
|
|
|
|
#### Core Flask Framework
|
|
- **Flask 3.1.1** - Neueste stabile Version
|
|
- **Flask-Login 0.6.3** - Benutzer-Authentifizierung
|
|
- **Flask-WTF 1.2.1** - CSRF-Schutz und Formulare
|
|
|
|
#### Datenbank
|
|
- **SQLAlchemy 2.0.36** - ORM für Datenbankoperationen
|
|
|
|
#### Sicherheit
|
|
- **Werkzeug 3.1.3** - WSGI-Utilities und Passwort-Hashing
|
|
- **bcrypt 4.2.1** - Passwort-Hashing
|
|
- **cryptography 44.0.0** - SSL-Zertifikate
|
|
|
|
#### Smart Plug Steuerung
|
|
- **PyP100 0.1.2** - TP-Link Tapo Smart Plugs (neueste verfügbare Version)
|
|
|
|
#### System & Monitoring
|
|
- **psutil 6.1.1** - System-Monitoring
|
|
- **redis 5.2.1** - Rate Limiting und Caching
|
|
- **requests 2.32.3** - HTTP-Anfragen
|
|
|
|
#### Template Engine
|
|
- **Jinja2 3.1.5** - Template-Rendering
|
|
- **MarkupSafe 3.0.2** - Sichere String-Verarbeitung
|
|
- **itsdangerous 2.2.0** - Sichere Daten-Serialisierung
|
|
|
|
#### Zusätzliche Core-Abhängigkeiten
|
|
- **click 8.1.8** - CLI-Kommandos
|
|
- **blinker 1.9.0** - Flask-Signaling
|
|
|
|
#### Windows-spezifisch
|
|
- **pywin32 308** - Windows-APIs (nur auf Windows)
|
|
|
|
## Kompatibilität
|
|
|
|
### Python-Versionen
|
|
- **Mindestversion**: Python 3.9
|
|
- **Empfohlen**: Python 3.11 oder 3.12
|
|
- **Getestet mit**: Python 3.13.3
|
|
|
|
### Betriebssysteme
|
|
- **Windows**: Vollständig unterstützt (mit pywin32)
|
|
- **Linux**: Vollständig unterstützt
|
|
- **macOS**: Vollständig unterstützt
|
|
|
|
## Wichtige Änderungen
|
|
|
|
### Was wurde entfernt
|
|
- **Nicht verwendete Pakete**: pandas, numpy, orjson, ujson, structlog
|
|
- **Entwicklungstools**: black, flake8, mypy (verschoben nach requirements-dev.txt)
|
|
- **Optionale Pakete**: watchdog, python-dotenv, sphinx
|
|
|
|
### Was wurde beibehalten
|
|
- **Nur tatsächlich verwendete Imports** aus app.py und Core-Modulen
|
|
- **Kritische Sicherheitspakete** für Produktionsbetrieb
|
|
- **Windows-Kompatibilität** für die Zielumgebung
|
|
|
|
## Installation mit Extras
|
|
|
|
### Entwicklungstools installieren
|
|
```bash
|
|
pip install -r requirements.txt
|
|
pip install pytest==8.3.4 pytest-cov==6.0.0
|
|
```
|
|
|
|
### Produktionsserver installieren
|
|
```bash
|
|
pip install -r requirements.txt
|
|
pip install gunicorn==23.0.0
|
|
```
|
|
|
|
## Wartung
|
|
|
|
### Requirements prüfen
|
|
```bash
|
|
# Installierte Pakete anzeigen
|
|
pip list
|
|
|
|
# Veraltete Pakete prüfen
|
|
pip list --outdated
|
|
|
|
# Abhängigkeitsbaum anzeigen
|
|
pip show --verbose Flask
|
|
```
|
|
|
|
### Sicherheitsupdates
|
|
```bash
|
|
# Sicherheitslücken prüfen (falls safety installiert)
|
|
pip install safety
|
|
safety check
|
|
|
|
# Alle Pakete aktualisieren
|
|
pip install --upgrade -r requirements.txt
|
|
```
|
|
|
|
## Troubleshooting
|
|
|
|
### Häufige Probleme
|
|
|
|
1. **PyP100 Installation**
|
|
- Version 0.1.2 ist die neueste verfügbare Version
|
|
- Bei Problemen: `pip install --no-deps PyP100==0.1.2`
|
|
|
|
2. **Dependency-Konflikte**
|
|
- flask-caching erfordert Flask<3, aber Flask 3.1.1 ist installiert
|
|
- Lösung: `pip install flask-caching --upgrade` oder entfernen
|
|
|
|
3. **Windows pywin32**
|
|
- Wird automatisch nur auf Windows installiert
|
|
- Bei Problemen: `pip install --force-reinstall pywin32`
|
|
|
|
4. **PATH-Warnungen**
|
|
- Scripts werden in User-Verzeichnis installiert
|
|
- Lösung: `--no-warn-script-location` verwenden
|
|
|
|
### Performance-Tipps
|
|
|
|
1. **Schnellere Installation**
|
|
```bash
|
|
pip install --upgrade pip
|
|
pip install -r requirements.txt --no-deps
|
|
```
|
|
|
|
2. **Cache nutzen**
|
|
```bash
|
|
pip install --cache-dir ~/.pip/cache -r requirements.txt
|
|
```
|
|
|
|
## Lizenz-Informationen
|
|
|
|
Alle verwendeten Pakete sind mit der MIT/BSD/Apache-Lizenz kompatibel.
|
|
|
|
---
|
|
|
|
**Letzte Aktualisierung**: Januar 2025
|
|
**Basis-Requirements**: Nur tatsächlich verwendete Imports
|
|
**Nächste Überprüfung**: April 2025 |