fairagro-middleware-shared 11.0.1.dev27__tar.gz → 11.0.1.dev28__tar.gz

{fairagro_middleware_shared-11.0.1.dev27 → fairagro_middleware_shared-11.0.1.dev28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fairagro-middleware-shared
-Version: 11.0.1.dev27
+Version: 11.0.1.dev28
 Summary: The FAIRagro advanced middleware shared components
 Requires-Python: >=3.12
 Requires-Dist: opentelemetry-api>=1.26.0

{fairagro_middleware_shared-11.0.1.dev27 → fairagro_middleware_shared-11.0.1.dev28}/src/middleware/shared/report/formats/jsonld.py

@@ -26,7 +26,15 @@ def _format_iso_duration(seconds: float) -> str:
 
 
 def _format_iso_timestamp(value: datetime) -> str:
-    """Format a UTC datetime value as an ISO 8601 timestamp ending in Z."""
+    """Format a timezone-aware datetime as an ISO 8601 UTC timestamp ending in Z.
+
+    Raises:
+        ValueError: If ``value`` is naive (no ``tzinfo``). Callers must supply
+            timezone-aware UTC times; treating naive values as local time would
+            silently shift the wall clock on non-UTC hosts.
+    """
+    if value.tzinfo is None:
+        raise ValueError("HarvestReport timestamps must be timezone-aware UTC")
     return value.astimezone(UTC).isoformat().replace("+00:00", "Z")
 
 

{fairagro_middleware_shared-11.0.1.dev27 → fairagro_middleware_shared-11.0.1.dev28}/tests/unit/test_harvest_report.py

@@ -131,6 +131,16 @@ def test_jsonld_timestamps_and_durations() -> None:
     assert document["schema:result"][0]["schema:duration"].startswith("PT")
 
 
+def test_jsonld_rejects_naive_timestamps() -> None:
+    """Naive start/end times must not be silently treated as local time."""
+    report = HarvestReport(
+        start_time=datetime(2026, 5, 6, 14, 0, 0),
+        end_time=datetime(2026, 5, 6, 14, 3, 45),
+    )
+    with pytest.raises(ValueError, match="timezone-aware"):
+        JsonLdReportSerializer().render(report)
+
+
 def test_jsonld_metrics_and_failed_records() -> None:
     """Fairagro metrics and nested failed records are emitted."""
     repo = _sample_repo()