96 lines
3.0 KiB
Python
96 lines
3.0 KiB
Python
"""Formatierungshelfer fuer Zeitangaben, Groessen und Pfade."""
|
|
|
|
from __future__ import annotations
|
|
|
|
from datetime import datetime, timezone
|
|
from pathlib import Path
|
|
|
|
|
|
def format_timestamp(seconds: float | int | None) -> str:
|
|
"""Formatiert Sekunden als HH:MM:SS bzw. MM:SS."""
|
|
if seconds is None:
|
|
return "--:--"
|
|
seconds = max(0, int(round(float(seconds))))
|
|
hours, remainder = divmod(seconds, 3600)
|
|
minutes, secs = divmod(remainder, 60)
|
|
if hours:
|
|
return f"{hours:02d}:{minutes:02d}:{secs:02d}"
|
|
return f"{minutes:02d}:{secs:02d}"
|
|
|
|
|
|
def format_timestamp_verbose(seconds: float | int | None) -> str:
|
|
"""Formatiert Sekunden immer als HH:MM:SS (fuer Fundstellen in Hoerspielen)."""
|
|
if seconds is None:
|
|
return "--:--:--"
|
|
seconds = max(0, int(round(float(seconds))))
|
|
hours, remainder = divmod(seconds, 3600)
|
|
minutes, secs = divmod(remainder, 60)
|
|
return f"{hours:02d}:{minutes:02d}:{secs:02d}"
|
|
|
|
|
|
def format_duration(seconds: float | int | None) -> str:
|
|
"""Menschlich lesbare Dauer, z. B. '2 h 14 min'."""
|
|
if seconds is None:
|
|
return "unbekannt"
|
|
total = max(0, int(round(float(seconds))))
|
|
hours, remainder = divmod(total, 3600)
|
|
minutes, secs = divmod(remainder, 60)
|
|
if hours:
|
|
return f"{hours} h {minutes:02d} min"
|
|
if minutes:
|
|
return f"{minutes} min {secs:02d} s"
|
|
return f"{secs} s"
|
|
|
|
|
|
def format_size(num_bytes: int | float | None) -> str:
|
|
"""Formatiert Bytes als B/KB/MB/GB."""
|
|
if num_bytes is None:
|
|
return "?"
|
|
value = float(num_bytes)
|
|
for unit in ("B", "KB", "MB", "GB", "TB"):
|
|
if value < 1024 or unit == "TB":
|
|
if unit == "B":
|
|
return f"{int(value)} {unit}"
|
|
return f"{value:.1f} {unit}"
|
|
value /= 1024
|
|
return f"{value:.1f} TB"
|
|
|
|
|
|
def format_score(score: float) -> str:
|
|
"""Aehnlichkeitswert als Prozentangabe (keine statistische Wahrscheinlichkeit)."""
|
|
return f"{score:.1f}%"
|
|
|
|
|
|
def format_rate(audio_seconds: float, elapsed_seconds: float) -> str:
|
|
"""Verarbeitungsgeschwindigkeit als Vielfaches der Echtzeit."""
|
|
if elapsed_seconds <= 0:
|
|
return "-"
|
|
return f"{audio_seconds / elapsed_seconds:.2f}x Echtzeit"
|
|
|
|
|
|
def format_datetime(iso_timestamp: str | None) -> str:
|
|
"""Formatiert einen ISO-String lesbar; unbekannte Formate werden durchgereicht."""
|
|
if not iso_timestamp:
|
|
return "-"
|
|
try:
|
|
dt = datetime.fromisoformat(iso_timestamp)
|
|
except ValueError:
|
|
return iso_timestamp
|
|
if dt.tzinfo is not None:
|
|
dt = dt.astimezone()
|
|
return dt.strftime("%Y-%m-%d %H:%M")
|
|
|
|
|
|
def utc_now_iso() -> str:
|
|
"""Aktueller Zeitpunkt als ISO-String in UTC (sekundengenau)."""
|
|
return datetime.now(timezone.utc).replace(microsecond=0).isoformat()
|
|
|
|
|
|
def shorten_path(path: str | Path, max_length: int = 80) -> str:
|
|
"""Kuerzt lange Pfade in der Mitte."""
|
|
text = str(path)
|
|
if len(text) <= max_length:
|
|
return text
|
|
keep = max(8, (max_length - 3) // 2)
|
|
return f"{text[:keep]}...{text[-keep:]}"
|