kurrentdbclient 1.3.2__tar.gz → 1.3.4__tar.gz

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kurrentdbclient
-Version: 1.3.2
+Version: 1.3.4
 Summary: Python gRPC Client for KurrentDB
 License: BSD-3-Clause
 License-File: LICENSE
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python
 Classifier: Topic :: Database
 Classifier: Topic :: Database :: Front-Ends
@@ -32,7 +33,7 @@ Project-URL: Repository, https://github.com/pyeventsourcing/kurrentdbclient
 Project-URL: issues, https://github.com/pyeventsourcing/kurrentdbclient/issues
 Description-Content-Type: text/markdown
 
-from uuid import uuid4<a href="https://kurrent.io">
+<a href="https://kurrent.io">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-White.png.png">
     <source media="(prefers-color-scheme: light)" srcset="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-Black.png">
@@ -59,7 +60,7 @@ features are presented in an easy-to-use interface.
 These clients have been tested to work with KurrentDB versions 25.0, 25.1, 26.0,
 and 26.1, and EventStoreDB versions 23.10 and 24.10, with and without SSL/TLS,
 in both single-server and cluster modes, across Python versions 3.10, 3.11, 3.12,
-3.13, and 3.14.
+3.13, 3.14, and 3.15.
 
 The test suite has 100% line and branch coverage. The code has typing annotations
 checked strictly with mypy. The code is formatted with black and isort, and checked
@@ -572,8 +573,8 @@ The table below describes the query string field-values supported by this client
 | GossipTimeout       | integer (default: 5)                                                  | The default value (in seconds) of the `timeout` argument of gossip read methods, such as `read_gossip()`.                                                         |
 | MaxDiscoverAttempts | integer (default: 10)                                                 | The number of attempts to read gossip when connecting or reconnecting to a cluster member.                                                                        |
 | DiscoveryInterval   | integer (default: 100)                                                | How long to wait (in milliseconds) between gossip retries.                                                                                                        |
-| KeepAliveInterval   | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_ms" gRPC channel option.                                                                                       |
-| KeepAliveTimeout    | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_timeout_ms" gRPC channel option.                                                                               |
+| KeepAliveInterval   | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_time_ms" gRPC channel option.                                                                                  |
+| KeepAliveTimeout    | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_timeout_ms" and "grpc.http2.ping_timeout_ms" gRPC channel options.                                             |
 | TlsCaFile           | string (default: `None`)                                              | Absolute filesystem path to file containing the CA certicate in PEM format. This will be used to verify the server's certificate.                                 |
 | UserCertFile        | string (default: `None`)                                              | Absolute filesystem path to file containing the X.509 user certificate in PEM format.                                                                             |
 | UserKeyFile         | string (default: `None`)                                              | Absolute filesystem path to file containing the X.509 user certificate's private key in PEM format.                                                               |

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/README.md

@@ -1,4 +1,4 @@
-from uuid import uuid4<a href="https://kurrent.io">
+<a href="https://kurrent.io">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-White.png.png">
     <source media="(prefers-color-scheme: light)" srcset="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-Black.png">
@@ -25,7 +25,7 @@ features are presented in an easy-to-use interface.
 These clients have been tested to work with KurrentDB versions 25.0, 25.1, 26.0,
 and 26.1, and EventStoreDB versions 23.10 and 24.10, with and without SSL/TLS,
 in both single-server and cluster modes, across Python versions 3.10, 3.11, 3.12,
-3.13, and 3.14.
+3.13, 3.14, and 3.15.
 
 The test suite has 100% line and branch coverage. The code has typing annotations
 checked strictly with mypy. The code is formatted with black and isort, and checked
@@ -538,8 +538,8 @@ The table below describes the query string field-values supported by this client
 | GossipTimeout       | integer (default: 5)                                                  | The default value (in seconds) of the `timeout` argument of gossip read methods, such as `read_gossip()`.                                                         |
 | MaxDiscoverAttempts | integer (default: 10)                                                 | The number of attempts to read gossip when connecting or reconnecting to a cluster member.                                                                        |
 | DiscoveryInterval   | integer (default: 100)                                                | How long to wait (in milliseconds) between gossip retries.                                                                                                        |
-| KeepAliveInterval   | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_ms" gRPC channel option.                                                                                       |
-| KeepAliveTimeout    | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_timeout_ms" gRPC channel option.                                                                               |
+| KeepAliveInterval   | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_time_ms" gRPC channel option.                                                                                  |
+| KeepAliveTimeout    | integer (default: `None`)                                             | The value (in milliseconds) of the "grpc.keepalive_timeout_ms" and "grpc.http2.ping_timeout_ms" gRPC channel options.                                             |
 | TlsCaFile           | string (default: `None`)                                              | Absolute filesystem path to file containing the CA certicate in PEM format. This will be used to verify the server's certificate.                                 |
 | UserCertFile        | string (default: `None`)                                              | Absolute filesystem path to file containing the X.509 user certificate in PEM format.                                                                             |
 | UserKeyFile         | string (default: `None`)                                              | Absolute filesystem path to file containing the X.509 user certificate's private key in PEM format.                                                               |

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/__init__.py

@@ -28,7 +28,7 @@ from kurrentdbclient.streams import (
     ReadResponse,
 )
 
-__version__ = "1.3.2"
+__version__ = "1.3.4"
 
 __all__ = [
     "DEFAULT_EXCLUDE_FILTER",

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/client.py

@@ -208,12 +208,16 @@ class BaseKurrentDBClient(ABC):
 
         self._default_deadline = self.connection_spec.options.default_deadline
 
+        # GRPC options ref: https://grpc.github.io/grpc/core/group__grpc__arg__keys.html
         self.grpc_options: GrpcOptions = (
             ("grpc.max_receive_message_length", 17 * 1024 * 1024),
         )
         if self.connection_spec.options.keep_alive_interval is not None:
             self.grpc_options += (
-                ("grpc.keepalive_ms", self.connection_spec.options.keep_alive_interval),
+                (
+                    "grpc.keepalive_time_ms",
+                    self.connection_spec.options.keep_alive_interval,
+                ),
             )
         if self.connection_spec.options.keep_alive_timeout is not None:
             self.grpc_options += (
@@ -221,6 +225,12 @@ class BaseKurrentDBClient(ABC):
                     "grpc.keepalive_timeout_ms",
                     self.connection_spec.options.keep_alive_timeout,
                 ),
+                # gRPC closes a connection whose ping is not answered after
+                # this time (default 60s), not after keepalive_timeout_ms.
+                (
+                    "grpc.http2.ping_timeout_ms",
+                    self.connection_spec.options.keep_alive_timeout,
+                ),
             )
 
         self._call_metadata = (

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/common.py

@@ -21,6 +21,7 @@ from weakref import WeakValueDictionary
 
 import grpc
 import grpc.aio
+from grpc.aio import AioRpcError
 from grpc_status import rpc_status
 from typing_extensions import Self
 
@@ -627,16 +628,23 @@ class AsyncRecordedEventIterator(
         self._is_context_manager_active = False
         await self.stop(timeout=5)
 
-    def _set_iter_error_for_testing(self) -> None:
+    def _set_iter_error_for_testing(self, msg: str) -> None:
         # This, because I can't find a good way to inspire an error during iterating
         # with catchup and persistent subscriptions after successfully
         # receiving confirmation response, tried closing the channel
         # but the async streaming response continues (unlike with sync call). Needed
         # to inspire this error to test instrumentation span error during iteration.
-        self._iter_error_for_testing = True
-
-    def _has_iter_error_for_testing(self) -> bool:
-        return getattr(self, "_iter_error_for_testing", False)
+        self._iter_error_for_testing = msg
+
+    def _check_iter_error_for_testing(self) -> None:
+        if msg := getattr(self, "_iter_error_for_testing", ""):
+            raise AioRpcError(
+                grpc.StatusCode.INTERNAL,
+                grpc.aio.Metadata(),
+                grpc.aio.Metadata(),
+                msg,
+                "",
+            )
 
 
 class AbstractAsyncReadResponse(AsyncRecordedEventIterator):

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/instrumentation/opentelemetry/spanners.py

@@ -966,8 +966,8 @@ class TracedAsyncRecordedEventIterator(
     async def __aexit__(self, *args: object, **kwargs: Any) -> None:
         return await self.response.__aexit__(*args, **kwargs)
 
-    def _set_iter_error_for_testing(self) -> None:
-        self.response._set_iter_error_for_testing()
+    def _set_iter_error_for_testing(self, msg: str) -> None:
+        self.response._set_iter_error_for_testing(msg)
 
     def __del__(self) -> None:
         current_span = self._current_span

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/persistent.py

@@ -18,7 +18,7 @@ from typing import (
 from uuid import UUID
 
 import grpc
-from grpc.aio import AioRpcError, StreamStreamCall
+from grpc.aio import StreamStreamCall
 from typing_extensions import Protocol, Self, TypedDict
 
 from kurrentdbclient.common import (
@@ -523,14 +523,7 @@ class AsyncPersistentSubscription(
             while True:
                 read_resp = await self._read_resp_iter.__anext__()
                 await self._read_resp_queue.put(read_resp)
-                if self._has_iter_error_for_testing():
-                    raise AioRpcError(
-                        grpc.StatusCode.INTERNAL,
-                        grpc.aio.Metadata(),
-                        grpc.aio.Metadata(),
-                        "",
-                        "",
-                    )
+                self._check_iter_error_for_testing()
         except BaseException:
             # Drain the queue (to avoid blocking on put).
             try:

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/kurrentdbclient/streams.py

@@ -14,7 +14,6 @@ from uuid import UUID, uuid4
 import grpc
 import grpc.aio
 from google.protobuf import any_pb2, duration_pb2, empty_pb2
-from grpc.aio import AioRpcError
 from typing_extensions import Protocol
 
 from kurrentdbclient.common import (
@@ -186,14 +185,7 @@ class AsyncReadResponse(BaseReadResponse, AsyncGrpcStreamer, AbstractAsyncReadRe
             while True:
                 read_resp = await self._read_resp_iter.__anext__()
                 await self._read_resp_queue.put(read_resp)
-                if self._has_iter_error_for_testing():
-                    raise AioRpcError(
-                        grpc.StatusCode.INTERNAL,
-                        grpc.aio.Metadata(),
-                        grpc.aio.Metadata(),
-                        "",
-                        "",
-                    )
+                self._check_iter_error_for_testing()
         except StopAsyncIteration:
             # End of the stream, signal to end the iteration.
             await self._read_resp_queue.put(None)

{kurrentdbclient-1.3.2 → kurrentdbclient-1.3.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "kurrentdbclient"
-version = "1.3.2"
+version = "1.3.4"
 description = "Python gRPC Client for KurrentDB"
 license = { text = "BSD-3-Clause" }
 readme = "README.md"
@@ -24,6 +24,7 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "Programming Language :: Python",
     "Topic :: Database",
     "Topic :: Database :: Front-Ends",]