cdo-toolkit 0.1.0__py3-none-any.whl

cdo_toolkit/resolution.py

@@ -0,0 +1,19 @@
+"""Resolution parsing helpers."""
+
+import re
+
+
+def calc_resolution(res: str | float | int) -> float:
+    """Parse nominal_resolution metadata into degrees."""
+    if isinstance(res, (float, int)):
+        return float(res)
+    if not res:
+        return 9999.0
+    res = str(res).lower().replace(" ", "")
+    if m := re.match(r"([\d.]+)km", res):
+        return float(m.group(1)) / 111.0
+    if m := re.match(r"([\d.]+)x([\d.]+)degree", res):
+        return (float(m.group(1)) + float(m.group(2))) / 2.0
+    if m := re.match(r"([\d.]+)degree", res):
+        return float(m.group(1))
+    return 9999.0

cdo_toolkit/timing.py

@@ -0,0 +1,36 @@
+"""Timing helpers for progress reporting."""
+
+import time
+from typing import Optional
+
+from rich.console import Console
+
+
+def print_timestamp(console: Console, message: str = "START") -> time.struct_time:
+    """Print a standardized timestamp using a Rich console."""
+    timestamp = time.localtime()
+    console.print(
+        f":clock3: {message}: {time.strftime('%Y-%m-%d %H:%M:%S', timestamp)}\n"
+    )
+    return timestamp
+
+
+def get_processing_time(start_time: time.struct_time, end_time: Optional[time.struct_time] = None) -> float:
+    """Return elapsed seconds between two struct_time values."""
+    if end_time is None:
+        end_time = time.localtime()
+    return time.mktime(end_time) - time.mktime(start_time)
+
+
+def format_processing_time(processing_time: Optional[float] = None) -> str:
+    """Format seconds as a human-readable duration string."""
+    if processing_time is None:
+        return "Timing not available"
+    hours = int(processing_time // 3600)
+    minutes = int((processing_time % 3600) // 60)
+    seconds = int(processing_time % 60)
+    if hours > 0:
+        return f"{hours}h {minutes}m {seconds}s"
+    if minutes > 0:
+        return f"{minutes}m {seconds}s"
+    return f"{seconds}s"