slm_open_api_package 0.2.13__tar.gz → 0.2.14__tar.gz

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: slm_open_api_package
-Version: 0.2.13
+Version: 0.2.14
 Summary: Add your description here
 Author: Sofus Vingaard
 Author-email: Sofus Vingaard <sofus.krebsvingaard@hbkworld.com>
@@ -82,6 +82,8 @@ except KeyboardInterrupt:
 
 JSON and CSV publish complete snapshots in a background worker, at most once per second while new data arrives, rather than rewriting the file for every sample. They retain records in memory and preserve their existing layouts; full-history snapshot costs still grow with recording length. Construct `JsonDataHandler(path, snapshot_interval=2.0)` or `CsvDataHandler(path, snapshot_interval=2.0)` and attach it with `setDataHandler()` to use a different interval. `close()` waits for the worker and saves all remaining records; background write failures are reported on subsequent updates or during the final flush. WAV still appends each audio chunk without buffering the recording in memory. `stopStream()` stops the measurement, closes saving handlers, and removes the device stream. Measurement saving formats are `"csv"` and `"json"`; audio uses `"wav"`. File extensions are added automatically.
 
+If snapshot replacement raises `PermissionError` (for example, Windows prevents replacing a CSV open in Excel), the worker warns once per failure episode, continues buffering records, and retries at the next snapshot interval. Close the program holding the output file open, or correct its permissions, to allow saving to resume. A lock still present at `close()` raises an error; unsaved records only remain in memory while the process is alive. Other write failures remain fatal to snapshot saving. `stopStream()` still attempts device cleanup if closing the saving handler fails.
+
 ## Multiple Sequences
 
 Based on [example_multi.py](src/slm_api/example_multi.py), use `mode="multi"` for several enabled broadband sequences in a single stream:

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/README.md

@@ -60,6 +60,8 @@ except KeyboardInterrupt:
 
 JSON and CSV publish complete snapshots in a background worker, at most once per second while new data arrives, rather than rewriting the file for every sample. They retain records in memory and preserve their existing layouts; full-history snapshot costs still grow with recording length. Construct `JsonDataHandler(path, snapshot_interval=2.0)` or `CsvDataHandler(path, snapshot_interval=2.0)` and attach it with `setDataHandler()` to use a different interval. `close()` waits for the worker and saves all remaining records; background write failures are reported on subsequent updates or during the final flush. WAV still appends each audio chunk without buffering the recording in memory. `stopStream()` stops the measurement, closes saving handlers, and removes the device stream. Measurement saving formats are `"csv"` and `"json"`; audio uses `"wav"`. File extensions are added automatically.
 
+If snapshot replacement raises `PermissionError` (for example, Windows prevents replacing a CSV open in Excel), the worker warns once per failure episode, continues buffering records, and retries at the next snapshot interval. Close the program holding the output file open, or correct its permissions, to allow saving to resume. A lock still present at `close()` raises an error; unsaved records only remain in memory while the process is alive. Other write failures remain fatal to snapshot saving. `stopStream()` still attempts device cleanup if closing the saving handler fails.
+
 ## Multiple Sequences
 
 Based on [example_multi.py](src/slm_api/example_multi.py), use `mode="multi"` for several enabled broadband sequences in a single stream:

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "slm_open_api_package"
-version = "0.2.13"
+version = "0.2.14"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.12"

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "slm_open_api_package"
-version = "0.2.13"
+version = "0.2.14"
 description = "Add your description here"
 readme = "README.md"
 authors = [

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/src/slm_api/helpers/data_handler.py

@@ -70,9 +70,20 @@ class _BufferedFileDataHandler(DataHandler):
                 self._worker.start()
 
     def _run_snapshots(self):
+        permission_error_reported = False
         while not self._stop_event.wait(self._snapshot_interval):
             try:
                 self._flush_snapshot()
+                permission_error_reported = False
+            except PermissionError as error:
+                if not permission_error_reported:
+                    warnings.warn(
+                        f"Cannot replace snapshot {self._path}: {error}. "
+                        "Close any program holding the file open. Records remain "
+                        "buffered in memory and saving will retry automatically.",
+                        RuntimeWarning,
+                    )
+                    permission_error_reported = True
             except Exception as error:
                 with self._lock:
                     self._write_error = error

{slm_open_api_package-0.2.13 → slm_open_api_package-0.2.14}/src/slm_api/helpers/stream_handlers.py

@@ -482,6 +482,8 @@ class WebXiStreamHandler(stream.StreamHandler):
                 print(f"TotalTime: {total}")
 
     def stopStream(self):
-        if self.data_handler is not None and hasattr(self.data_handler, "close"):
-            self.data_handler.close()
-        super().stopStream()
+        try:
+            if self.data_handler is not None and hasattr(self.data_handler, "close"):
+                self.data_handler.close()
+        finally:
+            super().stopStream()