Python-Entwicklung

# Python-Entwicklung

Erstellen Sie Python-Skripte, FastAPI-Services und Test-Suites mit modernen Tools — uv, PEP 723 und pytest-Best-Practices.

10 Minuten bis zum getesteten FastAPI-Service.

## Was dieses Plugin macht

Drei Skills, die den gesamten Python-Backend-Workflow abdecken:

| Skill | Zweck |
|-------|---------|
| **Python Scripting** | Eigenständige Skripte mit uv und PEP 723 Inline-Abhängigkeiten — keine virtualenv-Einrichtung erforderlich |
| **FastAPI Mastery** | REST-API-Erstellung mit Routing, Request-Validierung, Middleware, Auth und Datenbank-Integration |
| **pytest Mastery** | Test-Suites mit Fixtures, Parametrize, Mocking, Async-Testing und Coverage |

## Vollständiges Beispiel: URL-Shortener-API mit Tests erstellen

### Schritt 1: FastAPI-Service einrichten

```
Create a FastAPI URL shortener service with:
- POST /shorten — accepts {"url": "https://..."}, returns {"short_code": "abc123", "short_url": "http://localhost:8000/abc123"}
- GET /{short_code} — redirects to original URL
- GET /stats/{short_code} — returns click count
- Use SQLite via SQLAlchemy for storage
- Add input validation: reject invalid URLs, max URL length 2048
- Include proper error responses (404 for unknown codes, 422 for invalid input)
```

### Schritt 2: Umfassende Tests hinzufügen

```
Write pytest tests for the URL shortener:
- Test POST /shorten with valid URL returns 201 + short_code
- Test POST /shorten with invalid URL returns 422
- Test GET /{short_code} redirects correctly (status 307)
- Test GET /{short_code} with unknown code returns 404
- Test GET /stats/{short_code} returns correct click count after multiple visits
- Use httpx AsyncClient as test client
- Use a separate test database (SQLite in-memory)
- Add fixtures for: app client, sample shortened URL, database setup/teardown
```

### Schritt 3: Hilfsskript hinzufügen

```
Create a Python script with PEP 723 inline dependencies that:
- Reads a CSV file of URLs (one per line)
- Calls the /shorten endpoint for each URL
- Outputs a new CSV with original_url, short_url, short_code columns
- Use uv for dependency management (httpx, csv are dependencies)
- Add retry logic for failed requests
- Include a --dry-run flag that validates URLs without shortening
```

**Ergebnis:** Ein vollständiger, getesteter API-Service + ein Batch-Hilfsskript — alles generiert aus natürlichen Sprachbefehlen, bereit für die Bereitstellung.

## Umgebungsanforderungen

- **Python 3.10+** (3.12 empfohlen)
- **uv** Paketmanager für schnelle Abhängigkeitsauflösung:
  ```bash
  curl -LsSf https://astral.sh/uv/install.sh | sh
  ```
- Für FastAPI-Projekte werden Abhängigkeiten über `pyproject.toml` oder `requirements.txt` verwaltet
- Für eigenständige Skripte ermöglicht PEP 723 Inline-Metadaten die Deklaration von Abhängigkeiten direkt in der Skriptdatei — keine separate Konfiguration erforderlich

### Schnellprüfung

```bash
python3 --version   # 3.10+
uv --version        # any recent version
```

## Fehlerbehandlung

### uv nicht installiert

```
command not found: uv
```
**Lösung:** uv installieren: `curl -LsSf https://astral.sh/uv/install.sh | sh`
Alternativ Fallback auf pip: `pip install -r requirements.txt`

### Import-Fehler in Tests

```
ModuleNotFoundError: No module named 'httpx'
```
**Lösung:** Test-Abhängigkeiten installieren: `uv pip install httpx pytest pytest-asyncio`

### FastAPI-Server startet nicht

Häufige Ursachen:
- Port bereits belegt: `uvicorn app:app --port 8001`
- Fehlende Abhängigkeiten: `uv pip install fastapi uvicorn sqlalchemy`
- Python-Version zu alt: Upgrade auf 3.10+

### pytest-Fixtures nicht gefunden

Wenn Tests mit `fixture not found` fehlschlagen, stellen Sie sicher:
- `conftest.py` befindet sich im Testverzeichnis
- Fixture-Funktionen sind mit `@pytest.fixture` dekoriert
- Async-Fixtures verwenden `@pytest_asyncio.fixture`