155 lines
4.0 KiB
Markdown
155 lines
4.0 KiB
Markdown
|
---
|
|||
|
|
name: dep-update-check
|
|||
|
|
description: Prüft manuell, ob Python-Version und Projekt-Dependencies aktualisiert werden können, und testet die Kompatibilität. Verwende diesen Skill AUSSCHLIESSLICH wenn der Benutzer explizit danach fragt – z.B. '/dep-update-check', 'Prüfe Dependencies', 'Sind Updates verfügbar?', 'Kann ich Python updaten?'. Niemals automatisch auslösen.
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Dependency & Python Update Check
|
|||
|
|
|
|||
|
|
Dieser Skill prüft systematisch, welche Updates für das DocuMentor-Projekt verfügbar sind und ob sie kompatibel miteinander sind. Verwendete Werkzeuge: `uv`, `pyproject.toml`.
|
|||
|
|
|
|||
|
|
## Ablauf
|
|||
|
|
|
|||
|
|
Führe alle Schritte der Reihe nach aus und erstelle am Ende einen übersichtlichen Report.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Schritt 1: Python-Versionscheck
|
|||
|
|
|
|||
|
|
Lies die Python-Constraint aus `pyproject.toml` (Feld `requires-python`).
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
grep "requires-python" pyproject.toml
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Prüfe dann, welche stabilen Python-Versionen im erlaubten Bereich verfügbar sind:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
uv python list
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Stabile Versionen** sind jene ohne Suffix wie `b1`, `rc1`, `a1` oder `+freethreaded`. Filtere Beta- und Release-Candidate-Versionen heraus.
|
|||
|
|
|
|||
|
|
Vergleiche:
|
|||
|
|
- Aktuell verwendete Version: `uv run python --version`
|
|||
|
|
- Neueste stabile verfügbare Version innerhalb der Constraints
|
|||
|
|
|
|||
|
|
Falls eine neuere stabile Version verfügbar ist, notiere dies für den Report.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Schritt 2: Veraltete Dependencies ermitteln
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
uv tree --outdated
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Extrahiere daraus die **direkten** Projektabhängigkeiten (aus `pyproject.toml`, Abschnitte `[project] dependencies` und `[dependency-groups]`) und trenne sie von transitiven Abhängigkeiten.
|
|||
|
|
|
|||
|
|
Erstelle eine strukturierte Liste:
|
|||
|
|
- Direkte Dependencies: Name, aktuelle Version, neueste Version
|
|||
|
|
- Transitive Dependencies mit Updates (nur zur Information)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Schritt 3: Kompatibilitätstest
|
|||
|
|
|
|||
|
|
Sichere zunächst die aktuelle Lock-Datei:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cp uv.lock uv.lock.backup
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Versuche dann, alle Dependencies auf die neuesten kompatiblen Versionen aufzulösen:
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
uv lock --upgrade 2>&1
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**Interpretation:**
|
|||
|
|
- `Resolved X packages` ohne Fehler → alle Updates sind kompatibel
|
|||
|
|
- Fehlermeldungen über Versionskonflikte → notiere welche Pakete sich gegenseitig blockieren
|
|||
|
|
- Prüfe ob `uv.lock` verändert wurde: `diff uv.lock.backup uv.lock | head -50`
|
|||
|
|
|
|||
|
|
Stelle die Lock-Datei wieder her (wir wollen die Umgebung nicht tatsächlich ändern):
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
mv uv.lock.backup uv.lock
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Schritt 4: Report erstellen
|
|||
|
|
|
|||
|
|
Gib den Report im folgenden Format aus:
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🐍 Python-Version
|
|||
|
|
|
|||
|
|
| | Version |
|
|||
|
|
|---|---|
|
|||
|
|
| Aktuell in Verwendung | z.B. 3.13.11 |
|
|||
|
|
| Neueste stabile im erlaubten Bereich | z.B. 3.13.13 |
|
|||
|
|
| Update empfohlen? | Ja / Nein |
|
|||
|
|
|
|||
|
|
Falls ein Python-Update verfügbar ist, zeige den Befehl:
|
|||
|
|
```bash
|
|||
|
|
uv python install 3.X.Y
|
|||
|
|
# Dann in pyproject.toml requires-python anpassen falls nötig
|
|||
|
|
# Danach: uv sync
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 📦 Direkte Dependencies
|
|||
|
|
|
|||
|
|
Tabelle mit Spalten: Paket | Aktuell | Verfügbar | Status
|
|||
|
|
|
|||
|
|
Status-Symbole:
|
|||
|
|
- ✅ Aktuell
|
|||
|
|
- ⬆️ Update verfügbar
|
|||
|
|
- ⚠️ Update verfügbar, aber Kompatibilitätsproblem
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🔗 Transitive Dependencies (Auswahl)
|
|||
|
|
|
|||
|
|
Nur falls es relevante Updates gibt, kurze Liste.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 🔄 Kompatibilitäts-Ergebnis
|
|||
|
|
|
|||
|
|
Klares Fazit:
|
|||
|
|
- Können alle direkten Dependencies gleichzeitig aktualisiert werden? Ja/Nein
|
|||
|
|
- Falls Nein: Welche Konflikte bestehen und warum?
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 📋 Empfohlene Aktion
|
|||
|
|
|
|||
|
|
Falls Updates verfügbar und kompatibel:
|
|||
|
|
```bash
|
|||
|
|
uv sync --upgrade
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Falls nur einzelne Pakete aktualisiert werden sollen:
|
|||
|
|
```bash
|
|||
|
|
uv add paketname>=neue.version
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Falls Python aktualisiert werden soll (nur wenn innerhalb der Constraints):
|
|||
|
|
```bash
|
|||
|
|
uv python install 3.X.Y
|
|||
|
|
uv sync
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Hinweise
|
|||
|
|
|
|||
|
|
- **Nie `uv sync --upgrade` automatisch ausführen** – nur im Report vorschlagen, der Benutzer entscheidet.
|
|||
|
|
- Beta/RC-Python-Versionen werden nicht empfohlen (erkennbar an Suffixen wie `b1`, `rc1`).
|
|||
|
|
- `pyarrow` und andere native Pakete können bei Python-Upgrades besondere Anforderungen haben – darauf hinweisen falls relevant.
|
|||
|
|
- Wenn der `uv lock --upgrade`-Test fehlschlägt, die Lock-Datei **immer** aus dem Backup wiederherstellen.
|