firestarter 3.2.0__tar.gz → 3.2.1__tar.gz

{firestarter-3.2.0/firestarter.egg-info → firestarter-3.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firestarter
-Version: 3.2.0
+Version: 3.2.1
 Summary: EPROM programmer software for the Relatively Universal ROM Programmer
 Author-email: Henrik Olsson <henols@gmail.com>
 Project-URL: Homepage, https://github.com/henols/firestarter_app
@@ -37,6 +37,7 @@ Requires-Dist: syrupy<7,>=5.0; extra == "test"
 Requires-Dist: ruff>=0.15.14; extra == "test"
 Requires-Dist: mypy<3,>=2.1.0; extra == "test"
 Requires-Dist: pytest-cov>=7.1.0; extra == "test"
+Requires-Dist: pytest-xdist>=3.6; extra == "test"
 Requires-Dist: types-pyserial>=3.5.0.20260519; extra == "test"
 Dynamic: license-file
 

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '3.2.0'
-__version_tuple__ = version_tuple = (3, 2, 0)
+__version__ = version = '3.2.1'
+__version_tuple__ = version_tuple = (3, 2, 1)
 
-__commit_id__ = commit_id = 'g42fa55c'
+__commit_id__ = commit_id = 'g4526a89'

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter/cli_handlers.py

@@ -4,7 +4,6 @@ This module is the production CLI surface; main.py re-exports `cli` as `main`
 for the console-script entry point.
 """
 
-import datetime
 import functools
 import hashlib
 import json
@@ -106,6 +105,7 @@ from firestarter.protection_readability import (
     protection_gate_for_entry,
 )
 from firestarter.sdp_capability import SDP_PROTOCOL_ID, sdp_capability
+from firestarter.timestamps import iso_cet
 
 logger = logging.getLogger("Firestarter")
 
@@ -1908,10 +1908,10 @@ def fw(
 
             print(_json.dumps(releases, indent=2))
         else:
-            print(f"{'Version':<12} {'Channel':<14} {'Published':<22} Asset URL")
+            print(f"{'Version':<12} {'Channel':<14} {'Published':<25} Asset URL")
             for r in releases:
                 print(
-                    f"{r['version']:<12} {r['channel']:<14} {r['published']:<22} {r['asset_url']}"  # noqa: E501
+                    f"{r['version']:<12} {r['channel']:<14} {r['published']:<25} {r['asset_url']}"  # noqa: E501
                 )
             if not releases:
                 print(f"No releases found for board {board}.")
@@ -2638,7 +2638,7 @@ def _write_artifact(
     out_path.mkdir(parents=True, exist_ok=True)
 
     artifact: Dict[str, Any] = {  # noqa: UP006
-        "generated": datetime.datetime.now(datetime.UTC).strftime("%Y-%m-%dT%H:%M:%SZ"),
+        "generated": iso_cet(),
         "harness_version": "71",
         "cells": cells,
     }

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter/diagnostic_report.py

@@ -23,7 +23,6 @@ human-input field gates it.
 
 from __future__ import annotations
 
-import datetime
 import hashlib
 import json
 from dataclasses import dataclass, field
@@ -45,6 +44,7 @@ from firestarter.chip_test import (
     repeat_policy_tag,
     resolve_error_name,
 )
+from firestarter.timestamps import iso_cet
 
 # ---------------------------------------------------------------------------
 # Module constants -- single sources of truth
@@ -774,8 +774,8 @@ class DiagnosticReport:
     over dataclass fields, so this field's absence from that list is the
     whole exclusion mechanism."""
 
-    def _utc_now(self) -> str:
-        return datetime.datetime.now(datetime.UTC).strftime("%Y-%m-%dT%H:%M:%SZ")
+    def _now(self) -> str:
+        return iso_cet()
 
     def _auto_capture_dict(self) -> dict[str, Any]:
         ac = self.auto_capture
@@ -1065,7 +1065,7 @@ class DiagnosticReport:
         """
         return {
             "schema_version": SCHEMA_VERSION,
-            "generated": self._utc_now(),
+            "generated": self._now(),
             "elapsed": self.elapsed,
             "auto_capture": self._auto_capture_dict(),
             "transport_health": self._transport_dict(),

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter/eprom_operations.py

@@ -15,7 +15,6 @@ import shutil
 import statistics
 import time
 from contextlib import contextmanager
-from datetime import datetime
 from pathlib import Path
 from typing import Callable, Dict, Tuple  # noqa: UP035
 
@@ -75,6 +74,7 @@ from firestarter.serial_comm import (
     WRITE_BUDGET_MAX_S,
     SerialCommunicator,
 )
+from firestarter.timestamps import iso_cet_basic
 from firestarter.utils import extract_hex_to_decimal
 from firestarter.write_blank_guard import (
     incomplete_refusal_text,
@@ -1383,7 +1383,7 @@ class EpromOperator:
             # path is to use the actual board name -- but the unit-test
             # surface doesn't have a serial connection, so we fall back).
             if output_dir is None:
-                timestamp = datetime.now().strftime("%Y-%m-%d-%H%M%S")
+                timestamp = iso_cet_basic()
                 output_dir = str(
                     Path(DEFAULT_RUN_OUTPUT_DIR)
                     / f"consistency-check-{eprom_name}-unknown-board-{timestamp}"
@@ -1560,7 +1560,7 @@ class EpromOperator:
         source_sha = hashlib.sha256(Path(source_image_path).read_bytes()).hexdigest()
 
         if output_dir is None:
-            timestamp = datetime.now().strftime("%Y-%m-%d-%H%M%S")
+            timestamp = iso_cet_basic()
             output_dir = str(
                 Path(DEFAULT_RUN_OUTPUT_DIR)
                 / f"write-cycle-{eprom_name}-unknown-board-{timestamp}"
@@ -1678,7 +1678,7 @@ class EpromOperator:
         from firestarter.serial_comm import FaultInjectingSerialCommunicator
 
         if output_dir is None:
-            timestamp = datetime.now().strftime("%Y-%m-%d-%H%M%S")
+            timestamp = iso_cet_basic()
             output_dir = f"fault-inject-{eprom_name}-{direction}-{timestamp}"
         output_path = Path(output_dir)
         output_path.mkdir(parents=True, exist_ok=True)
@@ -1945,7 +1945,7 @@ class EpromOperator:
             return False
 
         if output_dir is None:
-            timestamp = datetime.now().strftime("%Y-%m-%d-%H%M%S")
+            timestamp = iso_cet_basic()
             output_dir = f"fault-inject-latency-{fault_form}-{timestamp}"
         output_path = Path(output_dir)
         output_path.mkdir(parents=True, exist_ok=True)
@@ -2149,7 +2149,7 @@ class EpromOperator:
             return False
 
         if output_dir is None:
-            timestamp = datetime.now().strftime("%Y-%m-%d-%H%M%S")
+            timestamp = iso_cet_basic()
             output_dir = f"connect-cost-{timestamp}"
         output_path = Path(output_dir)
         output_path.mkdir(parents=True, exist_ok=True)

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter/firmware.py

@@ -41,6 +41,7 @@ from firestarter.exceptions import (
 )
 from firestarter.fw_release_gate import require_installable_release
 from firestarter.serial_comm import SerialCommunicator
+from firestarter.timestamps import iso_text_to_cet
 
 logger = logging.getLogger("Firmware")
 
@@ -62,7 +63,7 @@ class ReleaseInfo(TypedDict):
     version: str  # tag_name from GitHub API
     tag: str  # raw tag_name (same as version for firmware releases)
     channel: str  # "stable" or "prerelease"
-    published: str  # ISO-8601 from published_at field
+    published: str  # published_at as ISO 8601 in CET
     asset_url: str  # browser_download_url for the board-matching .hex asset
 
 
@@ -468,7 +469,7 @@ class FirmwareManager:
                     version=tag,
                     tag=tag,
                     channel="prerelease" if is_pre else "stable",
-                    published=r.get("published_at") or "",
+                    published=iso_text_to_cet(r.get("published_at") or ""),
                     asset_url=asset_url,
                 )
             )

firestarter-3.2.1/firestarter/timestamps.py

@@ -0,0 +1,83 @@
+"""
+Project Name: Firestarter
+Copyright (c) 2024 Henrik Olsson
+
+Permission is hereby granted under MIT license.
+
+Timestamp Formatting Module
+
+Every timestamp the host writes is ISO 8601 in Central European Time: CET
+(UTC+01:00) in winter and CEST (UTC+02:00) during EU summer time. Summer time
+starts on the last Sunday of March and ends on the last Sunday of October, at
+01:00 UTC both times.
+
+The EU rule is computed here instead of through `zoneinfo`, because Windows
+and slim Linux images have no tz database and the app does not depend on the
+`tzdata` package.
+"""
+
+from __future__ import annotations
+
+import datetime
+
+_CET = datetime.timezone(datetime.timedelta(hours=1), "CET")
+_CEST = datetime.timezone(datetime.timedelta(hours=2), "CEST")
+
+
+def _last_sunday_0100_utc(year: int, month: int) -> datetime.datetime:
+    """01:00 UTC on the last Sunday of `month` (March or October, both 31 days)."""
+    last_day = datetime.datetime(year, month, 31, 1, tzinfo=datetime.UTC)
+    return last_day - datetime.timedelta(days=(last_day.weekday() + 1) % 7)
+
+
+def to_cet(moment: datetime.datetime) -> datetime.datetime:
+    """Return `moment` converted to CET or CEST.
+
+    Raises ValueError for a naive `moment`, because its zone is unknown.
+    """
+    if moment.tzinfo is None:
+        raise ValueError("to_cet() needs a timezone-aware datetime")
+    year = moment.astimezone(datetime.UTC).year
+    summer_start = _last_sunday_0100_utc(year, 3)
+    summer_end = _last_sunday_0100_utc(year, 10)
+    return moment.astimezone(_CEST if summer_start <= moment < summer_end else _CET)
+
+
+def now_cet() -> datetime.datetime:
+    """The current time in CET or CEST."""
+    return to_cet(datetime.datetime.now(datetime.UTC))
+
+
+def iso_cet(moment: datetime.datetime | None = None) -> str:
+    """ISO 8601 extended format, e.g. `2026-10-09T14:30:56+02:00`.
+
+    Uses the current time when `moment` is None.
+    """
+    cet = now_cet() if moment is None else to_cet(moment)
+    return cet.isoformat(timespec="seconds")
+
+
+def iso_cet_basic(moment: datetime.datetime | None = None) -> str:
+    """ISO 8601 basic format for file and directory names, e.g.
+    `20261009T143056+0200`.
+
+    The basic format has no colons. Windows does not permit a colon in a path.
+    Uses the current time when `moment` is None.
+    """
+    cet = now_cet() if moment is None else to_cet(moment)
+    return cet.strftime("%Y%m%dT%H%M%S%z")
+
+
+def iso_text_to_cet(text: str) -> str:
+    """Return the ISO 8601 timestamp `text` (e.g. GitHub's
+    `2026-01-01T00:00:00Z`) in CET, in extended format.
+
+    Returns `text` unchanged when it does not parse or has no UTC offset.
+    """
+    try:
+        moment = datetime.datetime.fromisoformat(text)
+    except (TypeError, ValueError):
+        return text
+    if moment.tzinfo is None:
+        return text
+    return iso_cet(moment)

{firestarter-3.2.0 → firestarter-3.2.1/firestarter.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: firestarter
-Version: 3.2.0
+Version: 3.2.1
 Summary: EPROM programmer software for the Relatively Universal ROM Programmer
 Author-email: Henrik Olsson <henols@gmail.com>
 Project-URL: Homepage, https://github.com/henols/firestarter_app
@@ -37,6 +37,7 @@ Requires-Dist: syrupy<7,>=5.0; extra == "test"
 Requires-Dist: ruff>=0.15.14; extra == "test"
 Requires-Dist: mypy<3,>=2.1.0; extra == "test"
 Requires-Dist: pytest-cov>=7.1.0; extra == "test"
+Requires-Dist: pytest-xdist>=3.6; extra == "test"
 Requires-Dist: types-pyserial>=3.5.0.20260519; extra == "test"
 Dynamic: license-file
 

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter.egg-info/SOURCES.txt

@@ -41,6 +41,7 @@ firestarter/sdp_capability.py
 firestarter/sdp_honesty.py
 firestarter/serial_comm.py
 firestarter/submit.py
+firestarter/timestamps.py
 firestarter/transport_counters.py
 firestarter/utils.py
 firestarter/vpp_display.py
@@ -159,6 +160,7 @@ tests/test_serial_comm.py
 tests/test_session_lease.py
 tests/test_setup_refusals.py
 tests/test_submit.py
+tests/test_timestamps.py
 tests/test_transport_counters.py
 tests/test_utils.py
 tests/test_uv_mask.py
@@ -203,12 +205,4 @@ tests/fixtures/reports/uv-slot-write-pass.json
 tests/fixtures/reports/w27e257-full-all-ok.json
 tests/golden/build_db_part_specific_constants.json
 tests/golden/chip_database_field_inventory.json
-tests/golden/wire_dict_baseline.json
-tests/golden/wire_dict_expected_deltas_149.json
-tests/golden/wire_dict_expected_deltas_153.json
-tests/golden/wire_dict_expected_deltas_182.json
-tests/golden/wire_dict_expected_deltas_194.json
-tests/golden/wire_dict_expected_deltas_197.json
-tests/golden/wire_dict_expected_deltas_198.json
-tests/golden/wire_dict_expected_deltas_199.json
-tests/golden/wire_dict_expected_deltas_dip24_2816.json
+tests/golden/wire_dict.json

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter.egg-info/requires.txt

@@ -17,4 +17,5 @@ syrupy<7,>=5.0
 ruff>=0.15.14
 mypy<3,>=2.1.0
 pytest-cov>=7.1.0
+pytest-xdist>=3.6
 types-pyserial>=3.5.0.20260519

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter.egg-info/scm_file_list.json

@@ -67,6 +67,7 @@
     "firestarter/sdp_honesty.py",
     "firestarter/serial_comm.py",
     "firestarter/submit.py",
+    "firestarter/timestamps.py",
     "firestarter/transport_counters.py",
     "firestarter/utils.py",
     "firestarter/vpp_display.py",
@@ -103,15 +104,7 @@
     "tests/fixtures/synthetic_nonzero_chip_id.py",
     "tests/golden/build_db_part_specific_constants.json",
     "tests/golden/chip_database_field_inventory.json",
-    "tests/golden/wire_dict_baseline.json",
-    "tests/golden/wire_dict_expected_deltas_149.json",
-    "tests/golden/wire_dict_expected_deltas_153.json",
-    "tests/golden/wire_dict_expected_deltas_182.json",
-    "tests/golden/wire_dict_expected_deltas_194.json",
-    "tests/golden/wire_dict_expected_deltas_197.json",
-    "tests/golden/wire_dict_expected_deltas_198.json",
-    "tests/golden/wire_dict_expected_deltas_199.json",
-    "tests/golden/wire_dict_expected_deltas_dip24_2816.json",
+    "tests/golden/wire_dict.json",
     "tests/plan_corpus.py",
     "tests/test_address_parser.py",
     "tests/test_b15_page_size_corroboration.py",
@@ -213,6 +206,7 @@
     "tests/test_session_lease.py",
     "tests/test_setup_refusals.py",
     "tests/test_submit.py",
+    "tests/test_timestamps.py",
     "tests/test_transport_counters.py",
     "tests/test_utils.py",
     "tests/test_uv_mask.py",

{firestarter-3.2.0 → firestarter-3.2.1}/firestarter.egg-info/scm_version.json

@@ -1,7 +1,7 @@
 {
-  "tag": "3.2.0",
+  "tag": "3.2.1",
   "distance": 0,
-  "node": "g42fa55c",
+  "node": "g4526a89",
   "dirty": false,
   "branch": "HEAD",
   "node_date": "2026-10-25"

{firestarter-3.2.0 → firestarter-3.2.1}/pyproject.toml

@@ -73,6 +73,7 @@ test = [
     "ruff>=0.15.14",
     "mypy>=2.1.0,<3",
     "pytest-cov>=7.1.0",
+    "pytest-xdist>=3.6",
     "types-pyserial>=3.5.0.20260519",
 ]
 

{firestarter-3.2.0 → firestarter-3.2.1}/tests/conftest.py

@@ -37,6 +37,7 @@ from __future__ import annotations
 
 import importlib.util
 import io
+import os
 import struct
 from typing import TYPE_CHECKING, cast
 from unittest.mock import Mock
@@ -96,6 +97,40 @@ collect_ignore: list = []
 if _pyusb_is_absent():
     collect_ignore.append("test_pyusb_api_surface.py")
 
+
+# `dev test` runs a `gh issue list --author @me` dedup query through
+# `submit.find_prior_report`, bound as a default argument, so patching the
+# module attribute does not reach it. A stub `gh` first on PATH answers every
+# call as "not authenticated" (exit 4): no test waits on GitHub, depends on the
+# developer's gh login, or branches on their real issues.
+@pytest.fixture(autouse=True)
+def _offline_gh(tmp_path_factory, monkeypatch):
+    bin_dir = tmp_path_factory.getbasetemp() / "offline-gh-bin"
+    gh = bin_dir / "gh"
+    if not gh.exists():
+        bin_dir.mkdir(exist_ok=True)
+        gh.write_text("#!/bin/sh\nexit 4\n")
+        gh.chmod(0o755)
+    monkeypatch.setenv("PATH", f"{bin_dir}{os.pathsep}{os.environ.get('PATH', '')}")
+
+
+# `disconnect()` drains the port with `consume_remaining_input(timeout=0.5)`.
+# A fake serial port answers every read at once, so the drain only ends when
+# the window runs out: 0.5 s of wall time per disconnect, a full second for a
+# write with a guard read. Any parsed frame restarts the window, so a short one
+# still drains everything a test fed. An explicit timeout is kept.
+@pytest.fixture(autouse=True)
+def _short_drain_window(monkeypatch):
+    from firestarter.serial_comm import SerialCommunicator
+
+    drain = SerialCommunicator.consume_remaining_input
+
+    def _short_drain(self, timeout: float = 0.02) -> None:
+        drain(self, timeout)
+
+    monkeypatch.setattr(SerialCommunicator, "consume_remaining_input", _short_drain)
+
+
 # Module-level reference constants — independent of firestarter.serial_comm
 # so tests do not pass tautologically on a bug in the production constant.
 MAGIC_PREAMBLE_REF: bytes = b"\xaa\x55\xaa\x55"