codegreen 0.4.7__tar.gz → 0.4.8__tar.gz

{codegreen-0.4.7/codegreen.egg-info → codegreen-0.4.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.4.7
+Version: 0.4.8
 Summary: Know the true energy cost of your code
 Author-email: Saurabhsingh Rajput <saurabh@dal.ca>
 Maintainer-email: Saurabhsingh Rajput <saurabh@dal.ca>

{codegreen-0.4.7 → codegreen-0.4.8}/codegreen/__init__.py

@@ -12,7 +12,7 @@ try:
     from importlib.metadata import version as _pkg_version
     __version__ = _pkg_version("codegreen")
 except Exception:
-    __version__ = "0.4.7"  # fallback for dev/editable installs
+    __version__ = "0.4.8"  # fallback for dev/editable installs
 __author__ = "Saurabhsingh Rajput"
 __email__ = "saurabh@dal.ca"
 __description__ = "Know the true energy cost of your code"

{codegreen-0.4.7 → codegreen-0.4.8}/codegreen/cli/cli.py

@@ -2676,9 +2676,11 @@ def run_command(
     from datetime import timezone as _tz
     from codegreen.instrumentation.language_runtimes.python.codegreen_runtime import (
         build_meta_block as _build_meta,
+        _iso_local_now,
     )
 
     _meta_started_at = datetime.now(_tz.utc).isoformat(timespec="microseconds")
+    _meta_started_at_local = _iso_local_now()
     _meta_t0_mono = time.monotonic()
     try:
         _meta_hostname = _socket.gethostname()
@@ -2713,6 +2715,8 @@ def run_command(
             run_id=_meta_run_id,
             started_at_iso=_meta_started_at,
             ended_at_iso=datetime.now(_tz.utc).isoformat(timespec="microseconds"),
+            started_at_local_iso=_meta_started_at_local,
+            ended_at_local_iso=_iso_local_now(),
             duration_total_s=time.monotonic() - _meta_t0_mono,
             hostname=_meta_hostname,
             session_name=None,
@@ -2831,10 +2835,13 @@ def run_command(
 
     if json_output:
         _meta_ended_at = datetime.now(_tz.utc).isoformat(timespec="microseconds")
+        _meta_ended_at_local = _iso_local_now()
         meta_obj = _build_meta(
             run_id=_meta_run_id,
             started_at_iso=_meta_started_at,
             ended_at_iso=_meta_ended_at,
+            started_at_local_iso=_meta_started_at_local,
+            ended_at_local_iso=_meta_ended_at_local,
             duration_total_s=time.monotonic() - _meta_t0_mono,
             hostname=_meta_hostname,
             session_name=None,

{codegreen-0.4.7 → codegreen-0.4.8}/codegreen/instrumentation/language_runtimes/python/codegreen_runtime.py

@@ -30,6 +30,19 @@ def _iso_utc_now() -> str:
     return datetime.now(timezone.utc).isoformat(timespec="microseconds")
 
 
+def _iso_local_now() -> str:
+    """Same instant as `_iso_utc_now()` rendered in the host's local timezone
+    with explicit offset, e.g. "2026-05-10T11:16:56.209074-07:00". Display-only
+    companion to the canonical UTC field; never use for joins/sorts."""
+    return datetime.now().astimezone().isoformat(timespec="microseconds")
+
+
+def _host_timezone_label() -> str:
+    """Best-effort local timezone label, e.g. 'PDT' or '+05:30'."""
+    tz = datetime.now().astimezone().tzinfo
+    return tz.tzname(datetime.now()) if tz else "unknown"
+
+
 def _runtime_version() -> str:
     try:
         from importlib.metadata import version as _v
@@ -145,6 +158,8 @@ def build_meta_block(
     domain_support: str = "none",
     domains: Optional[Dict[str, float]] = None,
     record_time_series: bool = False,
+    started_at_local_iso: str = "",
+    ended_at_local_iso: str = "",
     extras: Optional[Dict] = None,
 ) -> Dict:
     """Single canonical meta-block builder. Shared by Session._build_report()
@@ -171,6 +186,9 @@ def build_meta_block(
         "domain_support": domain_support,
         "outlier_method": rcfg["outlier_method"],
         "iso_timestamp_format": rcfg["iso_timestamp_format"],
+        "started_at_local": started_at_local_iso or _iso_local_now(),
+        "ended_at_local": ended_at_local_iso or _iso_local_now(),
+        "host_timezone": _host_timezone_label(),
         "nemb_abi_version": nemb_abi_version,
         "domain_topology": _domain_topology(domains or {}),
         "timeseries": ({
@@ -675,6 +693,8 @@ class Session:
         self._t0_mono: float = 0.0
         self._started_at_iso: str = ""
         self._ended_at_iso: str = ""
+        self._started_at_local_iso: str = ""
+        self._ended_at_local_iso: str = ""
         self._run_id: str = uuid.uuid4().hex[:12]
         try:
             self._hostname: str = socket.gethostname()
@@ -763,6 +783,7 @@ class Session:
         self._t0_wall = time.time()
         self._t0_mono = time.monotonic()
         self._started_at_iso = _iso_utc_now()
+        self._started_at_local_iso = _iso_local_now()
         _register_pid()
         _ensure_atexit()
         if self._record_ts:
@@ -974,6 +995,7 @@ class Session:
             return self._finalized_report
         if not self._ended_at_iso:
             self._ended_at_iso = _iso_utc_now()
+            self._ended_at_local_iso = _iso_local_now()
         total_e = sum(t.energy_j for t in self._tasks if t.depth == 0)
         wall_d = (time.monotonic() - self._t0_mono) if self._started else 0.0
         depth0 = [t for t in self._tasks if t.depth == 0]
@@ -1074,6 +1096,8 @@ class Session:
             run_id=self._run_id,
             started_at_iso=self._started_at_iso,
             ended_at_iso=self._ended_at_iso,
+            started_at_local_iso=self._started_at_local_iso,
+            ended_at_local_iso=self._ended_at_local_iso,
             duration_total_s=wall_d,
             hostname=self._hostname,
             session_name=self.name,

{codegreen-0.4.7 → codegreen-0.4.8/codegreen.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegreen
-Version: 0.4.7
+Version: 0.4.8
 Summary: Know the true energy cost of your code
 Author-email: Saurabhsingh Rajput <saurabh@dal.ca>
 Maintainer-email: Saurabhsingh Rajput <saurabh@dal.ca>

{codegreen-0.4.7 → codegreen-0.4.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "codegreen"
-version = "0.4.7"
+version = "0.4.8"
 description = "Know the true energy cost of your code"
 readme = "README.md"
 license = {file = "LICENSE"}

{codegreen-0.4.7 → codegreen-0.4.8}/tests/test_report_audit.py

@@ -177,6 +177,61 @@ class TestNamingContract:
         assert len(rid) == 12
         int(rid, 16)
 
+    def test_canonical_started_at_unchanged_with_local_field(self, workload_session: Dict) -> None:
+        """v0.4.8: adding started_at_local must NOT change started_at's UTC contract."""
+        v = workload_session["meta"]["started_at"]
+        assert v.endswith("+00:00")
+        assert "+00:00" in v
+
+
+# ===========================================================================
+# 2b. LOCAL TIMESTAMPS (v0.4.8+; additive, never replaces UTC fields)
+# ===========================================================================
+class TestLocalTimestamps:
+    """started_at_local, ended_at_local, host_timezone — display-only companions."""
+
+    def test_local_fields_present(self, workload_session: Dict) -> None:
+        m = workload_session["meta"]
+        for k in ("started_at_local", "ended_at_local", "host_timezone"):
+            assert k in m
+
+    def test_local_carries_offset_not_naive(self, workload_session: Dict) -> None:
+        m = workload_session["meta"]
+        s_local = m["started_at_local"]
+        e_local = m["ended_at_local"]
+        for v in (s_local, e_local):
+            parsed = datetime.fromisoformat(v)
+            assert parsed.tzinfo is not None, (
+                f"local timestamp must carry explicit offset, got {v!r}"
+            )
+
+    def test_local_and_utc_describe_same_instant(self, workload_session: Dict) -> None:
+        m = workload_session["meta"]
+        s_utc = datetime.fromisoformat(m["started_at"])
+        s_local = datetime.fromisoformat(m["started_at_local"])
+        delta = abs((s_utc - s_local).total_seconds())
+        assert delta < 0.001, (
+            f"started_at and started_at_local must point to the same instant; "
+            f"delta={delta}s"
+        )
+
+    def test_local_ordered_with_utc(self, workload_session: Dict) -> None:
+        m = workload_session["meta"]
+        s_local = datetime.fromisoformat(m["started_at_local"])
+        e_local = datetime.fromisoformat(m["ended_at_local"])
+        assert e_local > s_local
+
+    def test_host_timezone_label_nonempty(self, workload_session: Dict) -> None:
+        assert workload_session["meta"]["host_timezone"]
+        assert workload_session["meta"]["host_timezone"] != "unknown" or True
+
+    def test_canonical_utc_unaffected_when_local_present(self, workload_session: Dict) -> None:
+        """Sanity: the UTC field stays UTC even though local is also emitted."""
+        m = workload_session["meta"]
+        assert m["iso_timestamp_format"] == "rfc3339_utc"
+        assert m["started_at"].endswith("+00:00")
+        assert m["ended_at"].endswith("+00:00")
+
 
 # ===========================================================================
 # 3. LOGICAL CORRECTNESS