kurrentdbclient 0.4__tar.gz → 1.0b2__tar.gz

kurrentdbclient-0.4/README.md → kurrentdbclient-1.0b2/PKG-INFO

@@ -1,3 +1,41 @@
+Metadata-Version: 2.1
+Name: kurrentdbclient
+Version: 1.0b2
+Summary: Python gRPC Client for KurrentDB
+Home-page: https://github.com/pyeventsourcing/esdbclient
+License: BSD 3-Clause
+Author: John Bywater
+Author-email: john.bywater@appropriatesoftware.net
+Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: BSD License
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: opentelemetry
+Requires-Dist: grpcio (>=1.51.0,!=1.52.*,<1.69)
+Requires-Dist: opentelemetry-api (>=1.28.0,<2.0.0) ; extra == "opentelemetry"
+Requires-Dist: opentelemetry-instrumentation (>=0.49b0,<0.50) ; extra == "opentelemetry"
+Requires-Dist: opentelemetry-semantic-conventions (>=0.49b0,<0.50) ; extra == "opentelemetry"
+Requires-Dist: protobuf (>=3.11.0)
+Requires-Dist: typing_extensions
+Project-URL: Repository, https://github.com/pyeventsourcing/esdbclient
+Description-Content-Type: text/markdown
+
+<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">
+    <img alt="Kurrent" src="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-Plum.png" height="50%" width="50%">
+  </picture>
+</a>
+
 # Python gRPC Client for KurrentDB
 
 This [Python package](https://pypi.org/project/kurrentdbclient/) provides multithreaded and asyncio Python
@@ -7,13 +45,13 @@ The multithreaded `KurrentDBClient` is described in detail below. Please scroll
 down for <a href="#asyncio-client">information</a> about `AsyncKurrentDBClient`.
 
 These clients have been developed and are being maintained in a collaboration
-with the KurrentDB team, and are officially support by Kurrent Inc.
+with the KurrentDB team, and are officially supported by Kurrent Inc.
 Although not all aspects of the KurrentDB gRPC API are implemented, most
 features are presented in an easy-to-use interface.
 
-These clients have been tested to work with KurrentDB LTS versions 22.10, 23.10,
-and 24.10, without and without SSL/TLS, with both single-server
-and cluster modes, and with Python versions 3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
+These clients have been tested to work with KurrentDB 25.0.0, without and without
+SSL/TLS, with both single-server and cluster modes, and with Python versions
+3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
 
 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
@@ -75,10 +113,13 @@ https://github.com/pyeventsourcing/eventsourcing-eventstoredb) package.
 * [Projections](#projections)
   * [Create projection](#create-projection)
   * [Get projection state](#get-projection-state)
-  * [Get projection statistics](#get-projection-statistics)
   * [Update projection](#update-projection)
-  * [Enable projection](#enable-projection)
+  * [Get projection statistics](#get-projection-statistics)
+  * [List all projection statistics](#list-all-projection-statistics)
+  * [List continuous projection statistics](#list-continuous-projection-statistics)
   * [Disable projection](#disable-projection)
+  * [Enable projection](#enable-projection)
+  * [Abort projection](#abort-projection)
   * [Reset projection](#reset-projection)
   * [Delete projection](#delete-projection)
   * [Restart projections subsystem](#restart-projections-subsystem)
@@ -287,7 +328,7 @@ The KurrentDB server can be run locally using the official Docker container imag
 
 For development, you can run a "secure" KurrentDB server using the following command.
 
-    $ docker run -d --name kurrentdb-secure -it -p 2113:2113 --env "HOME=/tmp" docker.eventstore.com/eventstore/eventstoredb-ee:24.10.0-x64-8.0-bookworm-slim --dev
+    $ docker run -d --name kurrentdb-secure -it -p 2113:2113 --env "HOME=/tmp" docker.eventstore.com/kurrent-latest/kurrentdb:25.0.0-x64-8.0-bookworm-slim --dev
 
 As we will see, your client will need an KurrentDB connection string URI as the value
 of its `uri` constructor argument. The connection string for this "secure" KurrentDB
@@ -317,7 +358,7 @@ server_certificate = ssl.get_server_certificate(addr=('localhost', 2113))
 
 Alternatively, you can start an "insecure" server using the following command.
 
-    $ docker run -d --name kurrentdb-insecure -it -p 2113:2113 docker.eventstore.com/eventstore/eventstoredb-ee:24.10.0-x64-8.0-bookworm-slim --insecure
+    $ docker run -d --name kurrentdb-insecure -it -p 2113:2113 docker.eventstore.com/kurrent-latest/kurrentdb:25.0.0-x64-8.0-bookworm-slim --insecure
 
 The connection string URI for this "insecure" server would be:
 
@@ -2992,6 +3033,41 @@ projection_state = client.get_projection_state(name=projection_name)
 assert projection_state.value == {'count': 3}
 ```
 
+### Update projection<a id="update-projection"></a>
+
+*requires leader*
+
+The `update_projection()` method can be used to update a projection.
+
+This method has two required arguments, `name` and `query`.
+
+The required `name` argument is a Python `str` which specifies the name of the projection
+to be updated.
+
+The required `query` argument is a Python `str` which defines what the projection will do.
+
+This method also has three optional arguments, `emit_enabled`, `timeout`, and `credentials`.
+
+The optional `emit_enabled` argument is a Python `bool` which specifies whether a
+projection will be able to emit events. If a `True` value is specified, the projection
+will be able to emit events. If a `False` value is specified, the projection will not
+be able to emit events. The default value of `emit_enabled` is `False`.
+
+Please note, `emit_enabled` must be `True` if your projection query includes a call
+to `emit()`, otherwise the projection will not run.
+
+Please note, it is not possible to update `track_emitted_streams` via the gRPC API.
+
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
+
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
+
+```python
+client.update_projection(name=projection_name, query=projection_query)
+```
+
 ### Get projection statistics<a id="get-projection-statistics"></a>
 
 *requires leader*
@@ -3019,30 +3095,35 @@ statistics = client.get_projection_statistics(name=projection_name)
 A `ProjectionStatistics` object is returned. The attributes of this object
 have values that represent the progress of the projection.
 
-### Update projection<a id="update-projection"></a>
+
+### List all projection statistics<a id="list-all-projection-statistics"></a>
 
 *requires leader*
 
-The `update_projection()` method can be used to update a projection.
+The `list_all_projection_statistics()` method can be used to get a list of projection statistics for all projections.
 
-This method has two required arguments, `name` and `query`.
+This method has two optional arguments, `timeout` and `credentials`.
 
-The required `name` argument is a Python `str` which specifies the name of the projection
-to be updated.
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
 
-The required `query` argument is a Python `str` which defines what the projection will do.
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
 
-This method also has three optional arguments, `emit_enabled`, `timeout`, and `credentials`.
+This method returns a list of `ProjectionStatistics` objects that each represent
+a projection.
 
-The optional `emit_enabled` argument is a Python `bool` which specifies whether a
-projection will be able to emit events. If a `True` value is specified, the projection
-will be able to emit events. If a `False` value is specified, the projection will not
-be able to emit events. The default value of `emit_enabled` is `False`.
+```python
+statistics = client.list_all_projection_statistics()
+```
 
-Please note, `emit_enabled` must be `True` if your projection query includes a call
-to `emit()`, otherwise the projection will not run.
+### List continuous projection statistics<a id="list-continuous-projection-statistics"></a>
 
-Please note, it is not possible to update `track_emitted_streams` via the gRPC API.
+*requires leader*
+
+The `list_continuous_projection_statistics()` method can be used to get a list of projection statistics for all continuous projections.
+
+This method has two optional arguments, `timeout` and `credentials`.
 
 The optional `timeout` argument is a Python `float` which sets a
 maximum duration, in seconds, for the completion of the gRPC operation.
@@ -3050,8 +3131,33 @@ maximum duration, in seconds, for the completion of the gRPC operation.
 The optional `credentials` argument can be used to
 override call credentials derived from the connection string URI.
 
+This method returns a list of `ProjectionStatistics` objects that each represent
+a projection.
+
 ```python
-client.update_projection(name=projection_name, query=projection_query)
+statistics = client.list_continuous_projection_statistics()
+```
+
+### Disable projection<a id="disable-projection"></a>
+
+*requires leader*
+
+The `disable_projection()` method can be used to disable (stop running) a projection.
+When a projection is stopped using this method, a checkpoint will be written.
+
+This method has a required `name` argument, which is a Python `str` that
+specifies the name of the projection to be disabled.
+
+This method also has two optional arguments, `timeout`, and `credentials`.
+
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
+
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
+
+```python
+client.disable_projection(name=projection_name)
 ```
 
 ### Enable projection<a id="enable-projection"></a>
@@ -3076,11 +3182,13 @@ override call credentials derived from the connection string URI.
 client.enable_projection(name=projection_name)
 ```
 
-### Disable projection<a id="disable-projection"></a>
+### Abort projection<a id="abort-projection"></a>
 
 *requires leader*
 
-The `disable_projection()` method can be used to disable (stop running) a projection.
+The `abort_projection()` method can be used to abort (stop running) a projection.
+When a projection is stopped using this method, it will be stopped without writing
+a checkpoint.
 
 This method has a required `name` argument, which is a Python `str` that
 specifies the name of the projection to be disabled.
@@ -3094,7 +3202,7 @@ The optional `credentials` argument can be used to
 override call credentials derived from the connection string URI.
 
 ```python
-client.disable_projection(name=projection_name)
+client.abort_projection(name=projection_name)
 ```
 
 ### Reset projection<a id="reset-projection"></a>
@@ -3159,6 +3267,7 @@ client.delete_projection(name=projection_name)
 
 Please note, a projection must be disabled before it can be deleted.
 
+
 ### Restart projections subsystem<a id="restart-projections-subsystem"></a>
 
 *requires leader*
@@ -3736,3 +3845,4 @@ Update the `poetry.lock` file, and the project's virtual environment, using the
 following command.
 
     $ make update-packages
+

kurrentdbclient-0.4/PKG-INFO → kurrentdbclient-1.0b2/README.md

@@ -1,32 +1,10 @@
-Metadata-Version: 2.1
-Name: kurrentdbclient
-Version: 0.4
-Summary: Python gRPC Client for KurrentDB
-Home-page: https://github.com/pyeventsourcing/esdbclient
-License: BSD 3-Clause
-Author: John Bywater
-Author-email: john.bywater@appropriatesoftware.net
-Requires-Python: >=3.8,<4.0
-Classifier: Development Status :: 3 - Alpha
-Classifier: License :: OSI Approved :: BSD License
-Classifier: License :: Other/Proprietary License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Provides-Extra: opentelemetry
-Requires-Dist: grpcio (>=1.51.0,!=1.52.*,<1.69)
-Requires-Dist: opentelemetry-api (>=1.28.0,<2.0.0) ; extra == "opentelemetry"
-Requires-Dist: opentelemetry-instrumentation (>=0.49b0,<0.50) ; extra == "opentelemetry"
-Requires-Dist: opentelemetry-semantic-conventions (>=0.49b0,<0.50) ; extra == "opentelemetry"
-Requires-Dist: protobuf (>=3.11.0)
-Requires-Dist: typing_extensions
-Project-URL: Repository, https://github.com/pyeventsourcing/esdbclient
-Description-Content-Type: text/markdown
+<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">
+    <img alt="Kurrent" src="https://github.com/pyeventsourcing/kurrentdbclient/raw/1.0/KurrentLogo-Plum.png" height="50%" width="50%">
+  </picture>
+</a>
 
 # Python gRPC Client for KurrentDB
 
@@ -37,13 +15,13 @@ The multithreaded `KurrentDBClient` is described in detail below. Please scroll
 down for <a href="#asyncio-client">information</a> about `AsyncKurrentDBClient`.
 
 These clients have been developed and are being maintained in a collaboration
-with the KurrentDB team, and are officially support by Kurrent Inc.
+with the KurrentDB team, and are officially supported by Kurrent Inc.
 Although not all aspects of the KurrentDB gRPC API are implemented, most
 features are presented in an easy-to-use interface.
 
-These clients have been tested to work with KurrentDB LTS versions 22.10, 23.10,
-and 24.10, without and without SSL/TLS, with both single-server
-and cluster modes, and with Python versions 3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
+These clients have been tested to work with KurrentDB 25.0.0, without and without
+SSL/TLS, with both single-server and cluster modes, and with Python versions
+3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
 
 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
@@ -105,10 +83,13 @@ https://github.com/pyeventsourcing/eventsourcing-eventstoredb) package.
 * [Projections](#projections)
   * [Create projection](#create-projection)
   * [Get projection state](#get-projection-state)
-  * [Get projection statistics](#get-projection-statistics)
   * [Update projection](#update-projection)
-  * [Enable projection](#enable-projection)
+  * [Get projection statistics](#get-projection-statistics)
+  * [List all projection statistics](#list-all-projection-statistics)
+  * [List continuous projection statistics](#list-continuous-projection-statistics)
   * [Disable projection](#disable-projection)
+  * [Enable projection](#enable-projection)
+  * [Abort projection](#abort-projection)
   * [Reset projection](#reset-projection)
   * [Delete projection](#delete-projection)
   * [Restart projections subsystem](#restart-projections-subsystem)
@@ -317,7 +298,7 @@ The KurrentDB server can be run locally using the official Docker container imag
 
 For development, you can run a "secure" KurrentDB server using the following command.
 
-    $ docker run -d --name kurrentdb-secure -it -p 2113:2113 --env "HOME=/tmp" docker.eventstore.com/eventstore/eventstoredb-ee:24.10.0-x64-8.0-bookworm-slim --dev
+    $ docker run -d --name kurrentdb-secure -it -p 2113:2113 --env "HOME=/tmp" docker.eventstore.com/kurrent-latest/kurrentdb:25.0.0-x64-8.0-bookworm-slim --dev
 
 As we will see, your client will need an KurrentDB connection string URI as the value
 of its `uri` constructor argument. The connection string for this "secure" KurrentDB
@@ -347,7 +328,7 @@ server_certificate = ssl.get_server_certificate(addr=('localhost', 2113))
 
 Alternatively, you can start an "insecure" server using the following command.
 
-    $ docker run -d --name kurrentdb-insecure -it -p 2113:2113 docker.eventstore.com/eventstore/eventstoredb-ee:24.10.0-x64-8.0-bookworm-slim --insecure
+    $ docker run -d --name kurrentdb-insecure -it -p 2113:2113 docker.eventstore.com/kurrent-latest/kurrentdb:25.0.0-x64-8.0-bookworm-slim --insecure
 
 The connection string URI for this "insecure" server would be:
 
@@ -3022,6 +3003,41 @@ projection_state = client.get_projection_state(name=projection_name)
 assert projection_state.value == {'count': 3}
 ```
 
+### Update projection<a id="update-projection"></a>
+
+*requires leader*
+
+The `update_projection()` method can be used to update a projection.
+
+This method has two required arguments, `name` and `query`.
+
+The required `name` argument is a Python `str` which specifies the name of the projection
+to be updated.
+
+The required `query` argument is a Python `str` which defines what the projection will do.
+
+This method also has three optional arguments, `emit_enabled`, `timeout`, and `credentials`.
+
+The optional `emit_enabled` argument is a Python `bool` which specifies whether a
+projection will be able to emit events. If a `True` value is specified, the projection
+will be able to emit events. If a `False` value is specified, the projection will not
+be able to emit events. The default value of `emit_enabled` is `False`.
+
+Please note, `emit_enabled` must be `True` if your projection query includes a call
+to `emit()`, otherwise the projection will not run.
+
+Please note, it is not possible to update `track_emitted_streams` via the gRPC API.
+
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
+
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
+
+```python
+client.update_projection(name=projection_name, query=projection_query)
+```
+
 ### Get projection statistics<a id="get-projection-statistics"></a>
 
 *requires leader*
@@ -3049,30 +3065,35 @@ statistics = client.get_projection_statistics(name=projection_name)
 A `ProjectionStatistics` object is returned. The attributes of this object
 have values that represent the progress of the projection.
 
-### Update projection<a id="update-projection"></a>
+
+### List all projection statistics<a id="list-all-projection-statistics"></a>
 
 *requires leader*
 
-The `update_projection()` method can be used to update a projection.
+The `list_all_projection_statistics()` method can be used to get a list of projection statistics for all projections.
 
-This method has two required arguments, `name` and `query`.
+This method has two optional arguments, `timeout` and `credentials`.
 
-The required `name` argument is a Python `str` which specifies the name of the projection
-to be updated.
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
 
-The required `query` argument is a Python `str` which defines what the projection will do.
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
 
-This method also has three optional arguments, `emit_enabled`, `timeout`, and `credentials`.
+This method returns a list of `ProjectionStatistics` objects that each represent
+a projection.
 
-The optional `emit_enabled` argument is a Python `bool` which specifies whether a
-projection will be able to emit events. If a `True` value is specified, the projection
-will be able to emit events. If a `False` value is specified, the projection will not
-be able to emit events. The default value of `emit_enabled` is `False`.
+```python
+statistics = client.list_all_projection_statistics()
+```
 
-Please note, `emit_enabled` must be `True` if your projection query includes a call
-to `emit()`, otherwise the projection will not run.
+### List continuous projection statistics<a id="list-continuous-projection-statistics"></a>
 
-Please note, it is not possible to update `track_emitted_streams` via the gRPC API.
+*requires leader*
+
+The `list_continuous_projection_statistics()` method can be used to get a list of projection statistics for all continuous projections.
+
+This method has two optional arguments, `timeout` and `credentials`.
 
 The optional `timeout` argument is a Python `float` which sets a
 maximum duration, in seconds, for the completion of the gRPC operation.
@@ -3080,8 +3101,33 @@ maximum duration, in seconds, for the completion of the gRPC operation.
 The optional `credentials` argument can be used to
 override call credentials derived from the connection string URI.
 
+This method returns a list of `ProjectionStatistics` objects that each represent
+a projection.
+
 ```python
-client.update_projection(name=projection_name, query=projection_query)
+statistics = client.list_continuous_projection_statistics()
+```
+
+### Disable projection<a id="disable-projection"></a>
+
+*requires leader*
+
+The `disable_projection()` method can be used to disable (stop running) a projection.
+When a projection is stopped using this method, a checkpoint will be written.
+
+This method has a required `name` argument, which is a Python `str` that
+specifies the name of the projection to be disabled.
+
+This method also has two optional arguments, `timeout`, and `credentials`.
+
+The optional `timeout` argument is a Python `float` which sets a
+maximum duration, in seconds, for the completion of the gRPC operation.
+
+The optional `credentials` argument can be used to
+override call credentials derived from the connection string URI.
+
+```python
+client.disable_projection(name=projection_name)
 ```
 
 ### Enable projection<a id="enable-projection"></a>
@@ -3106,11 +3152,13 @@ override call credentials derived from the connection string URI.
 client.enable_projection(name=projection_name)
 ```
 
-### Disable projection<a id="disable-projection"></a>
+### Abort projection<a id="abort-projection"></a>
 
 *requires leader*
 
-The `disable_projection()` method can be used to disable (stop running) a projection.
+The `abort_projection()` method can be used to abort (stop running) a projection.
+When a projection is stopped using this method, it will be stopped without writing
+a checkpoint.
 
 This method has a required `name` argument, which is a Python `str` that
 specifies the name of the projection to be disabled.
@@ -3124,7 +3172,7 @@ The optional `credentials` argument can be used to
 override call credentials derived from the connection string URI.
 
 ```python
-client.disable_projection(name=projection_name)
+client.abort_projection(name=projection_name)
 ```
 
 ### Reset projection<a id="reset-projection"></a>
@@ -3189,6 +3237,7 @@ client.delete_projection(name=projection_name)
 
 Please note, a projection must be disabled before it can be deleted.
 
+
 ### Restart projections subsystem<a id="restart-projections-subsystem"></a>
 
 *requires leader*
@@ -3766,4 +3815,3 @@ Update the `poetry.lock` file, and the project's virtual environment, using the
 following command.
 
     $ make update-packages
-

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/kurrentdbclient/__init__.py

@@ -25,8 +25,6 @@ from kurrentdbclient.streams import (
     StreamState,
 )
 
-__version__ = "1.1"
-
 __all__ = [
     "DEFAULT_EXCLUDE_FILTER",
     "KDB_PERSISTENT_CONFIG_EVENTS_REGEX",

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/kurrentdbclient/asyncio_client.py

@@ -11,6 +11,7 @@ from typing import (
     Callable,
     Dict,
     Iterable,
+    List,
     Optional,
     Sequence,
     Tuple,
@@ -1512,6 +1513,45 @@ class AsyncKurrentDBClient(BaseKurrentDBClient):
             credentials=credentials or self._call_credentials,
         )
 
+    @retrygrpc
+    @autoreconnect
+    async def list_continuous_projection_statistics(
+        self,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:
+        """
+        Lists statistics for continuous projections.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        return await self._connection.projections.list_statistics(
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
+    @retrygrpc
+    @autoreconnect
+    async def list_all_projection_statistics(
+        self,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:
+        """
+        Lists statistics for all projections.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        return await self._connection.projections.list_statistics(
+            all=True,
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
     @retrygrpc
     @autoreconnect
     async def disable_projection(
@@ -1534,6 +1574,28 @@ class AsyncKurrentDBClient(BaseKurrentDBClient):
             credentials=credentials or self._call_credentials,
         )
 
+    @retrygrpc
+    @autoreconnect
+    async def abort_projection(
+        self,
+        name: str,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> None:
+        """
+        Aborts a projection.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        await self._connection.projections.disable(
+            name=name,
+            write_checkpoint=False,
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
     @retrygrpc
     @autoreconnect
     async def enable_projection(

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/kurrentdbclient/client.py

@@ -13,6 +13,7 @@ from typing import (
     Callable,
     Dict,
     Iterable,
+    List,
     Optional,
     Sequence,
     Tuple,
@@ -1752,7 +1753,7 @@ class KurrentDBClient(BaseKurrentDBClient):
         credentials: Optional[grpc.CallCredentials] = None,
     ) -> ProjectionStatistics:
         """
-        Gets projection statistics.
+        Gets statistics for named projection.
         """
         timeout = timeout if timeout is not None else self._default_deadline
 
@@ -1763,6 +1764,45 @@ class KurrentDBClient(BaseKurrentDBClient):
             credentials=credentials or self._call_credentials,
         )
 
+    @retrygrpc
+    @autoreconnect
+    def list_continuous_projection_statistics(
+        self,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:
+        """
+        Lists statistics for continuous projections.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        return self.projections.list_statistics(
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
+    @retrygrpc
+    @autoreconnect
+    def list_all_projection_statistics(
+        self,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:
+        """
+        Lists statistics for all projections.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        return self.projections.list_statistics(
+            all=True,
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
     @retrygrpc
     @autoreconnect
     def disable_projection(
@@ -1785,6 +1825,28 @@ class KurrentDBClient(BaseKurrentDBClient):
             credentials=credentials or self._call_credentials,
         )
 
+    @retrygrpc
+    @autoreconnect
+    def abort_projection(
+        self,
+        name: str,
+        *,
+        timeout: Optional[float] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> None:
+        """
+        Aborts a projection.
+        """
+        timeout = timeout if timeout is not None else self._default_deadline
+
+        self.projections.disable(
+            name=name,
+            write_checkpoint=False,
+            timeout=timeout,
+            metadata=self._call_metadata,
+            credentials=credentials or self._call_credentials,
+        )
+
     @retrygrpc
     @autoreconnect
     def enable_projection(
@@ -1795,7 +1857,7 @@ class KurrentDBClient(BaseKurrentDBClient):
         credentials: Optional[grpc.CallCredentials] = None,
     ) -> None:
         """
-        Disables a projection.
+        Enables a projection.
         """
         timeout = timeout if timeout is not None else self._default_deadline
 

kurrentdbclient-1.0b2/kurrentdbclient/instrumentation/opentelemetry/package.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+_instruments = (f"{__name__.split('.')[0]} == 1.0b2",)

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/kurrentdbclient/instrumentation/opentelemetry/version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = "1.1"
+__version__ = "1.0"

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/kurrentdbclient/projections.py

@@ -1,6 +1,8 @@
 # -*- coding: utf-8 -*-
+from __future__ import annotations
+
 from dataclasses import dataclass
-from typing import Any, Optional, Union
+from typing import Any, List, Optional, Union
 
 import grpc
 import grpc.aio
@@ -51,11 +53,6 @@ class ProjectionState:
     value: Any
 
 
-@dataclass(frozen=True)
-class ProjectionResult:
-    value: Any
-
-
 class BaseProjectionsService(KurrentDBService[TGrpcStreamers]):
     def __init__(
         self,
@@ -115,11 +112,21 @@ class BaseProjectionsService(KurrentDBService[TGrpcStreamers]):
 
     @staticmethod
     def _construct_statistics_req(
-        name: str,
+        *,
+        name: str | None = None,
+        all: bool = False,
     ) -> projections_pb2.StatisticsReq:
-        return projections_pb2.StatisticsReq(
-            options=projections_pb2.StatisticsReq.Options(name=name),
-        )
+        if name is not None:
+            options = projections_pb2.StatisticsReq.Options(name=name)
+        elif all:
+            options = projections_pb2.StatisticsReq.Options(
+                all=shared_pb2.Empty(),
+            )
+        else:
+            options = projections_pb2.StatisticsReq.Options(
+                continuous=shared_pb2.Empty(),
+            )
+        return projections_pb2.StatisticsReq(options=options)
 
     @staticmethod
     def _construct_disable_req(
@@ -351,6 +358,34 @@ class AsyncProjectionsService(BaseProjectionsService[AsyncGrpcStreamers]):
         except grpc.RpcError as e:
             raise handle_rpc_error(e) from None
 
+    async def list_statistics(
+        self,
+        all: bool = False,
+        timeout: Optional[float] = None,
+        metadata: Optional[Metadata] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:  # pragma: no cover
+        statistics_req = self._construct_statistics_req(all=all)
+        try:
+            statistics_resps = self._stub.Statistics(
+                statistics_req,
+                timeout=timeout,
+                metadata=self._metadata(metadata, requires_leader=True),
+                credentials=credentials,
+            )
+            list_of_projection_statistics = []
+            async for statistics_resp in statistics_resps:
+                assert isinstance(
+                    statistics_resp, projections_pb2.StatisticsResp
+                ), statistics_resp
+                projection_statistics = self._construct_projection_statistics(
+                    statistics_resp
+                )
+                list_of_projection_statistics.append(projection_statistics)
+            return list_of_projection_statistics
+        except grpc.RpcError as e:
+            raise handle_rpc_error(e) from None
+
     async def disable(
         self,
         name: str,
@@ -600,6 +635,34 @@ class ProjectionsService(BaseProjectionsService[GrpcStreamers]):
         except grpc.RpcError as e:
             raise handle_rpc_error(e) from None
 
+    def list_statistics(
+        self,
+        all: bool = False,
+        timeout: Optional[float] = None,
+        metadata: Optional[Metadata] = None,
+        credentials: Optional[grpc.CallCredentials] = None,
+    ) -> List[ProjectionStatistics]:  # pragma: no cover
+        statistics_req = self._construct_statistics_req(all=all)
+        try:
+            statistics_resps = self._stub.Statistics(
+                statistics_req,
+                timeout=timeout,
+                metadata=self._metadata(metadata, requires_leader=True),
+                credentials=credentials,
+            )
+            list_of_projection_statistics = []
+            for statistics_resp in statistics_resps:
+                assert isinstance(
+                    statistics_resp, projections_pb2.StatisticsResp
+                ), statistics_resp
+                projection_statistics = self._construct_projection_statistics(
+                    statistics_resp
+                )
+                list_of_projection_statistics.append(projection_statistics)
+            return list_of_projection_statistics
+        except grpc.RpcError as e:
+            raise handle_rpc_error(e) from None
+
     def disable(
         self,
         name: str,

{kurrentdbclient-0.4 → kurrentdbclient-1.0b2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "kurrentdbclient"
-version = "0.4"
+version = "1.0b2"
 
 description = "Python gRPC Client for KurrentDB"
 authors = [
@@ -8,8 +8,8 @@ authors = [
 ]
 license = "BSD 3-Clause"
 classifiers = [
-    "Development Status :: 3 - Alpha",
-#    "Development Status :: 4 - Beta",
+#    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
 #    "Development Status :: 5 - Production/Stable",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python :: 3",

kurrentdbclient-0.4/kurrentdbclient/instrumentation/opentelemetry/package.py

@@ -1,2 +0,0 @@
-# -*- coding: utf-8 -*-
-_instruments = (f"{__name__.split('.')[0]} >= 0.1",)