audio-validation 0.3.2__tar.gz → 0.3.3__tar.gz

{audio_validation-0.3.2 → audio_validation-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audio_validation
-Version: 0.3.2
+Version: 0.3.3
 Summary: Tools for validating audio data, including feature extraction and visualization.
 Maintainer-email: Hubert Stepniewski <hubert.stepniewski@int2code.com>, Marcin Tomiczek <marcin.tomiczek@int2code.com>, Piotr Sznapka <piotr.sznapka@int2code.com>
 License: MIT License

{audio_validation-0.3.2 → audio_validation-0.3.3}/RELEASE_NOTES.md

@@ -1,3 +1,7 @@
+### 0.3.3
+
+[PATCH] Add absolute timestamps in audio chunks.
+
 ### 0.3.2
 
 [PATCH] Add warmup chunks, improve failure reporting.

{audio_validation-0.3.2 → audio_validation-0.3.3}/src/audio_validation/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.2'
-__version_tuple__ = version_tuple = (0, 3, 2)
+__version__ = version = '0.3.3'
+__version_tuple__ = version_tuple = (0, 3, 3)
 
-__commit_id__ = commit_id = 'ge32c5a61b'
+__commit_id__ = commit_id = 'g1aaee7507'

{audio_validation-0.3.2 → audio_validation-0.3.3}/src/audio_validation/continous_validation/models.py

@@ -5,12 +5,15 @@ short-lived (only referenced by the bounded retention buffer).
 """
 
 from dataclasses import dataclass, field
+from datetime import datetime
 from textwrap import indent
 from typing import List, Optional
 
 import numpy as np
 import pandas as pd
 
+WALL_CLOCK_UNKNOWN = "-"
+
 
 def format_timestamp(seconds: float) -> str:
     """Render *seconds* since capture start as ``HH:MM:SS.mmm``.
@@ -28,6 +31,18 @@ def format_timestamp(seconds: float) -> str:
     return f"{hours:02d}:{minutes:02d}:{secs:02d}.{millis:03d}"
 
 
+def format_wall_clock(timestamp: Optional[datetime]) -> str:
+    """Render an absolute chunk timestamp as ``YYYY-MM-DD HH:MM:SS.mmm``.
+
+    :param timestamp: Absolute chunk time, or ``None`` when not recorded.
+    :return: Millisecond-precision timestamp, or ``"-"`` when *timestamp* is
+        ``None``.
+    """
+    if timestamp is None:
+        return WALL_CLOCK_UNKNOWN
+    return timestamp.strftime("%Y-%m-%d %H:%M:%S.%f")[:-3]
+
+
 @dataclass
 class RawChunk:
     """One contiguous captured block, tagged with its position in the run.
@@ -36,12 +51,15 @@ class RawChunk:
     :ivar start_s: Start time in seconds relative to capture start.
     :ivar end_s: End time in seconds relative to capture start.
     :ivar samples: 2-D array ``(n_samples, channels)``.
+    :ivar start_timestamp: Absolute wall-clock time of the chunk's first sample,
+        or ``None`` when the capture start time is unknown.
     """
 
     index: int
     start_s: float
     end_s: float
     samples: np.ndarray
+    start_timestamp: Optional[datetime] = None
 
 
 @dataclass
@@ -63,6 +81,8 @@ class ChunkMetrics:
     :ivar reason: Single-line failure summary, suited to a table column.
     :ivar detail: Multiline failure report with the per-check channel tables;
         never put this in a DataFrame cell, log it separately.
+    :ivar start_timestamp: Absolute wall-clock time of the chunk's first sample,
+        or ``None`` when the capture start time is unknown.
     """
 
     index: int
@@ -72,6 +92,7 @@ class ChunkMetrics:
     reason: str
     detail: str = ""
     channels: List[ChannelMetric] = field(default_factory=list)
+    start_timestamp: Optional[datetime] = None
 
 
 @dataclass
@@ -124,7 +145,8 @@ class ValidationResult:  # pylint: disable=too-many-instance-attributes
         multiline table crammed into one cell wrecks the table layout.
 
         ``start``/``end`` are rendered as ``HH:MM:SS.mmm`` offsets from capture
-        start rather than raw seconds.
+        start rather than raw seconds; ``timestamp`` is the absolute wall-clock
+        time of the chunk's first sample, for lining chunks up with DUT logs.
         """
         rows = []
         for metric in self.metrics:
@@ -132,6 +154,7 @@ class ValidationResult:  # pylint: disable=too-many-instance-attributes
                 rows.append(
                     {
                         "index": metric.index,
+                        "timestamp": format_wall_clock(metric.start_timestamp),
                         "start": format_timestamp(metric.start_s),
                         "end": format_timestamp(metric.end_s),
                         "ch": ch_idx,

{audio_validation-0.3.2 → audio_validation-0.3.3}/src/audio_validation/continous_validation/validator.py

@@ -19,6 +19,7 @@ import threading
 from concurrent.futures import CancelledError, Future, ThreadPoolExecutor
 from concurrent.futures import wait as futures_wait
 from dataclasses import dataclass, replace
+from datetime import datetime, timedelta
 import time
 from typing import Callable, List, Optional
 
@@ -149,6 +150,7 @@ class ContinuousAudioValidator:  # pylint: disable=too-many-instance-attributes
         self._error: Optional[str] = None
 
         self._captured_time_s = 0.0
+        self._capture_started_at: Optional[datetime] = None
         self._consec_fail = 0
         self._stop_requested = False
         self._play_stopped = False
@@ -258,6 +260,17 @@ class ContinuousAudioValidator:  # pylint: disable=too-many-instance-attributes
             except Exception:  # pylint: disable=broad-except
                 logger.exception("recorder.stop_capture() raised")
 
+    def _chunk_timestamp(self, chunk_start_s: float) -> Optional[datetime]:
+        """Return the absolute time of a chunk starting *chunk_start_s* into the run.
+        Chunk timestamps are derived from capture start plus the sample-count offset,
+
+        :param chunk_start_s: Chunk start offset from capture start, in seconds.
+        :return: Wall-clock chunk start, or ``None`` before capture started.
+        """
+        if self._capture_started_at is None:
+            return None
+        return self._capture_started_at + timedelta(seconds=chunk_start_s)
+
     def _read_chunks(self) -> None:
         """
         Read chunks from the recorder and put them into the queue.
@@ -266,6 +279,7 @@ class ContinuousAudioValidator:  # pylint: disable=too-many-instance-attributes
         total_samples = 0
         try:
             self._recorder.start_capture()
+            self._capture_started_at = datetime.now()
             while not self._stop.is_set() and not self._abort.is_set():
 
                 if (
@@ -293,7 +307,13 @@ class ContinuousAudioValidator:  # pylint: disable=too-many-instance-attributes
                 chunk_end_s = total_samples / self._sample_rate
                 self._captured_time_s = chunk_end_s
                 self._enqueue_chunk(
-                    RawChunk(chunk_idx, chunk_start_s, chunk_end_s, chunk)
+                    RawChunk(
+                        chunk_idx,
+                        chunk_start_s,
+                        chunk_end_s,
+                        chunk,
+                        self._chunk_timestamp(chunk_start_s),
+                    )
                 )
                 chunk_idx += 1
         except Exception as exc:  # pylint: disable=broad-except
@@ -357,6 +377,7 @@ class ContinuousAudioValidator:  # pylint: disable=too-many-instance-attributes
             index=chunk.index,
             start_s=chunk.start_s,
             end_s=chunk.end_s,
+            start_timestamp=chunk.start_timestamp,
             ok=verdict.ok,
             reason="warm-up (not evaluated)" if warmup else verdict.summary,
             detail=verdict.detail,

{audio_validation-0.3.2 → audio_validation-0.3.3}/src/audio_validation.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: audio_validation
-Version: 0.3.2
+Version: 0.3.3
 Summary: Tools for validating audio data, including feature extraction and visualization.
 Maintainer-email: Hubert Stepniewski <hubert.stepniewski@int2code.com>, Marcin Tomiczek <marcin.tomiczek@int2code.com>, Piotr Sznapka <piotr.sznapka@int2code.com>
 License: MIT License

audio_validation-0.3.3/src/audio_validation.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.3",
+  "distance": 0,
+  "node": "g1aaee750785afc79b6f331c4bd0e497c7e4b11a5",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-08-07"
+}

audio_validation-0.3.2/src/audio_validation.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.3.2",
-  "distance": 0,
-  "node": "ge32c5a61ba2f0d187518620dd508fd43f8e2e24f",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-08-06"
-}