nominal-streaming 0.5.7__cp310-abi3-musllinux_1_2_aarch64.whl → 0.7.5__cp310-abi3-musllinux_1_2_aarch64.whl

nominal_streaming/_nominal_streaming.pyi

@@ -4,6 +4,8 @@ import pathlib
 from types import TracebackType
 from typing import Sequence, Type
 
+from typing_extensions import Self
+
 from nominal_streaming.nominal_dataset_stream import DataType
 
 class PyNominalStreamOpts:
@@ -108,7 +110,7 @@ class PyNominalStreamOpts:
             True
         """
 
-    def with_max_points_per_batch(self, n: int) -> PyNominalStreamOpts:
+    def with_max_points_per_batch(self, n: int) -> Self:
         """Set the maximum number of points per record.
 
         Args:
@@ -121,7 +123,7 @@ class PyNominalStreamOpts:
             >>> opts = PyNominalStreamOpts.default().with_max_points_per_batch(1000)
         """
 
-    def with_max_request_delay_secs(self, delay_secs: float) -> PyNominalStreamOpts:
+    def with_max_request_delay_secs(self, delay_secs: float) -> Self:
         """Set the maximum delay before forcing a request flush.
 
         Args:
@@ -134,7 +136,7 @@ class PyNominalStreamOpts:
             >>> opts = PyNominalStreamOpts.default().with_max_request_delay_secs(1.0)
         """
 
-    def with_max_buffered_requests(self, n: int) -> PyNominalStreamOpts:
+    def with_max_buffered_requests(self, n: int) -> Self:
         """Set the maximum number of requests that can be buffered concurrently.
 
         Args:
@@ -147,7 +149,7 @@ class PyNominalStreamOpts:
             >>> opts = PyNominalStreamOpts.default().with_max_buffered_requests(200)
         """
 
-    def with_num_upload_workers(self, n: int) -> PyNominalStreamOpts:
+    def with_num_upload_workers(self, n: int) -> Self:
         """Set the number of asynchronous dispatcher tasks.
 
         Args:
@@ -160,7 +162,7 @@ class PyNominalStreamOpts:
             >>> opts = PyNominalStreamOpts.default().with_num_upload_workers(8)
         """
 
-    def with_num_runtime_workers(self, n: int) -> PyNominalStreamOpts:
+    def with_num_runtime_workers(self, n: int) -> Self:
         """Set the number of runtime worker threads.
 
         Args:
@@ -173,7 +175,7 @@ class PyNominalStreamOpts:
             >>> opts = PyNominalStreamOpts.default().with_num_runtime_workers(16)
         """
 
-    def with_api_base_url(self, url: str) -> PyNominalStreamOpts:
+    def with_api_base_url(self, url: str) -> Self:
         """Set the base URL for the Nominal API.
 
         Args:
@@ -211,7 +213,7 @@ class PyNominalDatasetStream:
             >>> stream = PyNominalDatasetStream(PyNominalStreamOpts())
         """
 
-    def enable_logging(self, log_directive: str | None = None) -> PyNominalDatasetStream:
+    def enable_logging(self, log_directive: str | None = None) -> Self:
         """Enable client-side logging for diagnostics.
 
         NOTE: must be applied before calling open()
@@ -225,7 +227,7 @@ class PyNominalDatasetStream:
             The updated instance for fluent chaining.
         """
 
-    def with_options(self, opts: PyNominalStreamOpts) -> PyNominalDatasetStream:
+    def with_options(self, opts: PyNominalStreamOpts) -> Self:
         """Attach or replace stream options.
 
         NOTE: must be applied before calling open()
@@ -241,7 +243,7 @@ class PyNominalDatasetStream:
         self,
         dataset_rid: str,
         token: str | None = None,
-    ) -> PyNominalDatasetStream:
+    ) -> Self:
         """Send data to a Dataset in Nominal.
 
         NOTE: Must be applied before calling open()
@@ -259,7 +261,7 @@ class PyNominalDatasetStream:
             RuntimeError: If called after `to_file`.
         """
 
-    def to_file(self, path: pathlib.Path) -> PyNominalDatasetStream:
+    def to_file(self, path: pathlib.Path) -> Self:
         """Write points to a local file (newline-delimited records).
 
         Mutually exclusive with `with_core_consumer`.
@@ -274,7 +276,7 @@ class PyNominalDatasetStream:
             RuntimeError: If already configured for core consumption.
         """
 
-    def with_file_fallback(self, path: pathlib.Path) -> PyNominalDatasetStream:
+    def with_file_fallback(self, path: pathlib.Path) -> Self:
         """If sending to core fails, fall back to writing to `path`.
 
         NOTE: Requires that `with_core_consumer` has been configured.
@@ -371,7 +373,7 @@ class PyNominalDatasetStream:
             TypeError: If any value is not an `int`, `float`, or `str`.
         """
 
-    def __enter__(self) -> PyNominalDatasetStream: ...
+    def __enter__(self) -> Self: ...
     def __exit__(
         self, exc_type: Type[BaseException] | None, exc_value: BaseException | None, traceback: TracebackType | None
     ) -> None: ...

nominal_streaming/nominal_dataset_stream.py

@@ -38,6 +38,7 @@ from types import TracebackType
 from typing import Mapping, Sequence, Type
 
 import dateutil
+from typing_extensions import Self
 
 from nominal_streaming._nominal_streaming import (
     PyNominalDatasetStream,
@@ -88,7 +89,7 @@ class NominalDatasetStream:
         max_buffered_requests: int = 4,
         num_upload_workers: int = 8,
         num_runtime_workers: int = 8,
-    ) -> NominalDatasetStream:
+    ) -> Self:
         """Factory constructor to build a NominalDatasetStream using optional overrides for configuration options
 
         Args:
@@ -117,7 +118,7 @@ class NominalDatasetStream:
         )
         return cls(auth_header, opts)
 
-    def enable_logging(self, log_directive: str = "debug") -> NominalDatasetStream:
+    def enable_logging(self, log_directive: str = "debug") -> Self:
         """Enable logging with the given verbosity level
 
         Args:
@@ -128,7 +129,7 @@ class NominalDatasetStream:
         self._impl = self._impl.enable_logging(log_directive)
         return self
 
-    def with_core_consumer(self, dataset_rid: str) -> NominalDatasetStream:
+    def with_core_consumer(self, dataset_rid: str) -> Self:
         """Enables streaming to a Dataset in Core
 
         Args:
@@ -137,7 +138,7 @@ class NominalDatasetStream:
         self._impl = self._impl.with_core_consumer(dataset_rid, self._auth_header)
         return self
 
-    def to_file(self, path: pathlib.Path) -> NominalDatasetStream:
+    def to_file(self, path: pathlib.Path) -> Self:
         """Target streaming towards a local `.avro` file
 
         The written file will contain snappy-compressed avro data. This can be read as follows:
@@ -156,7 +157,7 @@ class NominalDatasetStream:
         self._impl = self._impl.to_file(path)
         return self
 
-    def with_file_fallback(self, path: pathlib.Path) -> NominalDatasetStream:
+    def with_file_fallback(self, path: pathlib.Path) -> Self:
         """Setup file fallback for streaming to core
 
         The written file will contain snappy-compressed avro data for any batches of data that were unable to make
@@ -176,7 +177,7 @@ class NominalDatasetStream:
         self._impl = self._impl.with_file_fallback(path)
         return self
 
-    def open(self) -> NominalDatasetStream:
+    def open(self) -> Self:
         """Create the stream as a context manager.
 
         NOTE: installs a sigint handler to enable more graceful shutdown.
@@ -201,7 +202,7 @@ class NominalDatasetStream:
         signal.signal(signal.SIGINT, _on_sigint)
         return self
 
-    def __enter__(self) -> NominalDatasetStream:
+    def __enter__(self) -> Self:
         """Create the stream as a context manager.
 
         NOTE: installs a sigint handler to enable more graceful shutdown.

{nominal_streaming-0.5.7.dist-info → nominal_streaming-0.7.5.dist-info}/METADATA

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: nominal-streaming
-Version: 0.5.7
+Version: 0.7.5
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Rust
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Requires-Dist: typing-extensions>=4,<5
 Requires-Dist: python-dateutil>=0.0.0
 Summary: Python bindings for the Nominal Rust streaming client
 License: MIT
@@ -29,7 +30,7 @@ It also provides configuration to manage the tradeoff between above listed conce
 > [!WARNING]
 > This library is still under active development and may make breaking changes.
 
-## Simple usage example: streaming from memory to Nominal Core with file fallback
+## Usage example: streaming from memory to Nominal Core with file fallback
 
 ```python
 import pathlib
@@ -42,7 +43,7 @@ if __name__ == "__main__":
     num_points = 100_000
     stream = (
         NominalDatasetStream(
-            auth_header="<api key>", 
+            auth_header="<api key>",
             opts=PyNominalStreamOpts(),
         )
         .enable_logging("info") # can set debug, warn, etc.
@@ -56,18 +57,17 @@ if __name__ == "__main__":
             time_ns = int(time.time() * 1e9)
             value = (idx % 50) + 0.5
             stream.enqueue("channel_name", time_ns, value, tags={"tag_key": "tag_value"})
-        
+
         # Stream 100_000 points in one batch
         start_time = int(time.time() * 1e9)
         timestamp_offsets = int(1e9 / 1600)
         timestamps = [start_time + timestamp_offsets * idx for idx in range(num_points)]
         values = [(idx % 50) + 0.5 for idx in range(num_points)]
         stream.enqueue_batch(
-            "channel_name", 
-            timestamps, 
-            values, 
+            "channel_name",
+            timestamps,
+            values,
             tags={"tag_key": "tag_value"}
         )
-
 ```
 

nominal_streaming-0.7.5.dist-info/RECORD

@@ -0,0 +1,9 @@
+nominal_streaming-0.7.5.dist-info/METADATA,sha256=-VAuBpQmXYwBXhdYcqQ0mBaHzo4JLcBZPClyKl0Sn58,2814
+nominal_streaming-0.7.5.dist-info/WHEEL,sha256=EYTFw83l-1Egr0yK8_y3A2oK6lLpVyAvyCNXIbM92ys,107
+nominal_streaming.libs/libgcc_s-39080030.so.1,sha256=fIO6GHOh8Ft9CR0Geu7wSUb9Xnl122iTtrxQQ9TAkTQ,789673
+nominal_streaming/__init__.py,sha256=7isEI7NFTEnTNEmxjtDgehQQPPRM-ByrH903VBWrulQ,202
+nominal_streaming/_nominal_streaming.abi3.so,sha256=e8HEO8_eRgxsM1ICfXsFx_zvdPg0-3I_nIgIq7L-Bno,7867937
+nominal_streaming/_nominal_streaming.pyi,sha256=hZ5TpAFFMZzajSu13yh-klEh81ItvF5C5f_3i0rMfkM,12093
+nominal_streaming/nominal_dataset_stream.py,sha256=0OXLiGDhyT9Q4z0QJlXaV7H3Nd3OWMPi2bjQJKcM5eE,11507
+nominal_streaming/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nominal_streaming-0.7.5.dist-info/RECORD,,

nominal_streaming-0.5.7.dist-info/RECORD

@@ -1,9 +0,0 @@
-nominal_streaming-0.5.7.dist-info/METADATA,sha256=gXg2ftUuJbNasPY71BdJAyk-udzthfGz3wn8gpcauvM,2795
-nominal_streaming-0.5.7.dist-info/WHEEL,sha256=EYTFw83l-1Egr0yK8_y3A2oK6lLpVyAvyCNXIbM92ys,107
-nominal_streaming.libs/libgcc_s-39080030.so.1,sha256=fIO6GHOh8Ft9CR0Geu7wSUb9Xnl122iTtrxQQ9TAkTQ,789673
-nominal_streaming/__init__.py,sha256=7isEI7NFTEnTNEmxjtDgehQQPPRM-ByrH903VBWrulQ,202
-nominal_streaming/_nominal_streaming.abi3.so,sha256=a_xRIgTFY6IStnV_w5jgr1saRq5FIhjlJ7q9ZZUugNE,8064505
-nominal_streaming/_nominal_streaming.pyi,sha256=iWvKG8baZ7kZpDWOzvIigHEl9fg18cA6DIh4ch-y03Y,12255
-nominal_streaming/nominal_dataset_stream.py,sha256=bldR0-7aFU05MXn0adwKuAWEQVE4EiBQ2FuKXJMc7mw,11584
-nominal_streaming/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nominal_streaming-0.5.7.dist-info/RECORD,,