NEUE BACKEND-MODULE:
math_utils.py
- haversine_km(lat1, lon1, lat2, lon2) — Distanz in km
- haversine_m(...) — Convenience-Wrapper in Metern
- bbox_deg_from_km(lat, radius_km) — Bounding-Box-Approximation
für SQL-Vorfilter (statt Haversine im Python-Loop)
config.py
- DB_PATH, MEDIA_DIR, BREEDER_DOCS_DIR, SCANINPUT_DIR
- API_TIMEOUT_SHORT (5s) / DEFAULT (10s) / LONG (30s)
- HTTP_USER_AGENT, HTTP_HEADERS
errors.py
- not_found(msg), forbidden(msg), bad_request(msg), unauthorized(msg)
- conflict(msg), too_many_requests(msg, retry_after), service_unavailable(msg)
- require_or_404(row, msg) — Convenience-Helper
UI.JS ERWEITERUNGEN:
UI.time erweitert:
- formatDate(d) → "15.03.2026"
- formatDateTime(d) → "15.03.2026, 14:30"
- weekday(d) → "Di"
- parseISO(str) → {year, month, day}
UI.text (neu):
- truncate(str, maxLen, ellipsis='…')
- slug(str) — URL-Slug aus String (mit DE-Umlauten)
UI.money (neu):
- format(value) → "12,34 €" (de-DE, EUR)
- formatWithSuffix(value, '/Jahr')
HAVERSINE-MIGRATION (13 Backend-Routen):
alerts.py, services.py, places.py, events.py, diary.py, playdate.py,
lost.py, poison.py, adoption.py, gassi_zeiten.py, sitting.py, routen.py,
walks.py
- Alle lokalen def _haversine/haversine_km entfernt
- Aufrufe ersetzt durch haversine_km/haversine_m je nach Einheit
- from math_utils import haversine_km|haversine_m in jeder Datei
Tests 19/19 grün.
Hinweis: Migrationen für MEDIA_DIR (19 Stellen), API-Timeouts (12),
Date-Formatter im Frontend (24) und UI.text.truncate (5) sind als
Folge-Sprints möglich. Helper sind verfügbar.
47 lines
1.4 KiB
Python
47 lines
1.4 KiB
Python
"""Standardisierte HTTP-Exceptions — vermeidet inkonsistente Texte
|
|
in 200+ raise-Statements."""
|
|
from fastapi import HTTPException
|
|
|
|
|
|
def not_found(msg: str = "Nicht gefunden") -> HTTPException:
|
|
"""404. Beispiel: `raise not_found('Hund nicht gefunden')`."""
|
|
return HTTPException(404, msg)
|
|
|
|
|
|
def forbidden(msg: str = "Kein Zugriff") -> HTTPException:
|
|
"""403."""
|
|
return HTTPException(403, msg)
|
|
|
|
|
|
def bad_request(msg: str = "Ungültige Eingabe") -> HTTPException:
|
|
"""400."""
|
|
return HTTPException(400, msg)
|
|
|
|
|
|
def unauthorized(msg: str = "Nicht angemeldet") -> HTTPException:
|
|
"""401."""
|
|
return HTTPException(401, msg)
|
|
|
|
|
|
def conflict(msg: str = "Konflikt") -> HTTPException:
|
|
"""409."""
|
|
return HTTPException(409, msg)
|
|
|
|
|
|
def too_many_requests(msg: str = "Zu viele Anfragen", retry_after: int | None = None) -> HTTPException:
|
|
"""429. Optional mit Retry-After Header (in Sekunden)."""
|
|
headers = {"Retry-After": str(retry_after)} if retry_after else None
|
|
return HTTPException(429, msg, headers=headers)
|
|
|
|
|
|
def service_unavailable(msg: str = "Dienst gerade nicht verfügbar") -> HTTPException:
|
|
"""503."""
|
|
return HTTPException(503, msg)
|
|
|
|
|
|
def require_or_404(row, msg: str = "Nicht gefunden"):
|
|
"""Convenience: wirft 404 wenn row None/falsy, sonst gibt row zurück.
|
|
Beispiel: `dog = require_or_404(conn.execute(...).fetchone(), 'Hund nicht gefunden')`"""
|
|
if not row:
|
|
raise not_found(msg)
|
|
return row
|