neuroglia-python 0.6.17__tar.gz → 0.7.8__tar.gz

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: neuroglia-python
-Version: 0.6.17
+Version: 0.7.8
 Summary: Port from .NET to Python of the Neuroglia Framework
 License: Apache
 License-File: LICENSE
@@ -21,43 +21,44 @@ Provides-Extra: etcd
 Provides-Extra: eventstore
 Provides-Extra: mongodb
 Provides-Extra: redis
-Requires-Dist: annotated-types (>=0.7.0,<0.8.0)
-Requires-Dist: apscheduler (>=3.11.0,<4.0.0)
-Requires-Dist: boto3 (>=1.40.64,<2.0.0) ; extra == "aws" or extra == "all"
-Requires-Dist: classy-fastapi (>=0.6.1,<0.7.0)
-Requires-Dist: email-validator (>=2.2.0,<3.0.0)
-Requires-Dist: esdbclient (>=1.1.1,<2.0.0) ; extra == "eventstore" or extra == "all"
-Requires-Dist: etcd3-py (>=0.1.6,<0.2.0) ; extra == "etcd" or extra == "all"
-Requires-Dist: fastapi (>=0.115.5,<0.116.0)
-Requires-Dist: grpcio (>=1.68.1,<2.0.0)
-Requires-Dist: httpx (>=0.27.2,<0.28.0)
-Requires-Dist: itsdangerous (>=2.2.0,<3.0.0)
-Requires-Dist: jinja2 (>=3.1.4,<4.0.0)
-Requires-Dist: motor (>=3.6.0,<4.0.0) ; extra == "mongodb" or extra == "all"
-Requires-Dist: multipledispatch (>=1.0.0,<2.0.0)
-Requires-Dist: opentelemetry-api (>=1.28.2,<2.0.0)
-Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (>=1.28.2,<2.0.0)
-Requires-Dist: opentelemetry-exporter-otlp-proto-http (>=1.28.2,<2.0.0)
-Requires-Dist: opentelemetry-exporter-prometheus (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-instrumentation (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-instrumentation-fastapi (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-instrumentation-httpx (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-instrumentation-logging (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-instrumentation-system-metrics (>=0.49b2,<0.50)
-Requires-Dist: opentelemetry-sdk (>=1.28.2,<2.0.0)
-Requires-Dist: passlib[bcrypt] (>=1.7.4,<2.0.0)
-Requires-Dist: prometheus-client (>=0.21.0,<0.22.0)
-Requires-Dist: protobuf (>=5.0,<6.0) ; extra == "etcd" or extra == "all"
-Requires-Dist: pydantic-settings (>=2.6.1,<3.0.0)
-Requires-Dist: pydantic[email] (>=2.10.3,<3.0.0)
-Requires-Dist: pyjwt (>=2.10.1,<3.0.0)
-Requires-Dist: pymongo (>=4.10.1,<5.0.0) ; extra == "mongodb" or extra == "all"
-Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
-Requires-Dist: python-multipart (>=0.0.17,<0.0.18)
-Requires-Dist: redis (>=5.2.0,<6.0.0) ; extra == "redis" or extra == "all"
-Requires-Dist: rx (>=3.2.0,<4.0.0)
-Requires-Dist: typing-extensions (>=4.12.2,<5.0.0)
-Requires-Dist: uvicorn (>=0.32.1,<0.33.0)
+Requires-Dist: annotated-types (==0.7.0)
+Requires-Dist: apscheduler (==3.11.0)
+Requires-Dist: boto3 (==1.40.64) ; extra == "aws" or extra == "all"
+Requires-Dist: classy-fastapi (==0.6.1)
+Requires-Dist: email-validator (==2.2.0)
+Requires-Dist: etcd3-py (==0.1.6) ; extra == "etcd" or extra == "all"
+Requires-Dist: fastapi (==0.115.5)
+Requires-Dist: grpcio (==1.76.0)
+Requires-Dist: h11 (==0.16.0)
+Requires-Dist: httpx (==0.27.2)
+Requires-Dist: itsdangerous (==2.2.0)
+Requires-Dist: jinja2 (==3.1.4)
+Requires-Dist: kurrentdbclient (==1.1.2) ; extra == "eventstore" or extra == "all"
+Requires-Dist: motor (==3.7.0) ; extra == "mongodb" or extra == "all"
+Requires-Dist: multipledispatch (==1.0.0)
+Requires-Dist: opentelemetry-api (==1.38.0)
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc (==1.38.0)
+Requires-Dist: opentelemetry-exporter-otlp-proto-http (==1.38.0)
+Requires-Dist: opentelemetry-exporter-prometheus (==0.59b0)
+Requires-Dist: opentelemetry-instrumentation (==0.59b0)
+Requires-Dist: opentelemetry-instrumentation-fastapi (==0.59b0)
+Requires-Dist: opentelemetry-instrumentation-httpx (==0.59b0)
+Requires-Dist: opentelemetry-instrumentation-logging (==0.59b0)
+Requires-Dist: opentelemetry-instrumentation-system-metrics (==0.59b0)
+Requires-Dist: opentelemetry-sdk (==1.38.0)
+Requires-Dist: passlib[bcrypt] (==1.7.4)
+Requires-Dist: prometheus-client (==0.21.0)
+Requires-Dist: protobuf (==6.33.1) ; extra == "etcd" or extra == "all"
+Requires-Dist: pydantic-settings (==2.6.1)
+Requires-Dist: pydantic[email] (==2.10.3)
+Requires-Dist: pyjwt (==2.10.1)
+Requires-Dist: pymongo (==4.15.4) ; extra == "mongodb" or extra == "all"
+Requires-Dist: python-dotenv (==1.0.1)
+Requires-Dist: python-multipart (==0.0.17)
+Requires-Dist: redis (==5.2.0) ; extra == "redis" or extra == "all"
+Requires-Dist: rx (==3.2.0)
+Requires-Dist: typing-extensions (==4.12.2)
+Requires-Dist: uvicorn (==0.32.1)
 Description-Content-Type: text/markdown
 
 # Neuroglia Python Framework

neuroglia_python-0.7.8/pyproject.toml

@@ -0,0 +1,97 @@
+[tool.poetry]
+name = "neuroglia-python"
+version = "0.7.8"
+description = "Port from .NET to Python of the Neuroglia Framework"
+authors = ["Charles d'Avernas <charles.davernas@neuroglia.io>", "Bruno van de Werve <bvandewe@gmail.com>"]
+license = "Apache"
+readme = "README.md"
+packages = [
+    { include = "neuroglia", from = "src" },
+]
+package-mode = true
+
+[tool.poetry.dependencies]
+python = "^3.9"
+# Core framework dependencies - always required
+annotated-types = "0.7.0"
+classy-fastapi = "0.6.1"
+fastapi = "0.115.5"
+multipledispatch = "1.0.0"
+pydantic-settings = "2.6.1"
+python-dotenv = "1.0.1"
+typing-extensions = "4.12.2"
+rx = { version = "3.2.0" }
+uvicorn = { version = "0.32.1" }
+httpx = { version = "0.27.2" }
+grpcio = { version = "1.76.0" }
+h11 = { version = "0.16.0" }  # Security fix for CVE-2025-43859
+
+# Authentication dependencies
+pyjwt = "2.10.1"
+passlib = { extras = ["bcrypt"], version = "1.7.4" }
+python-multipart = "0.0.17"
+itsdangerous = "2.2.0"
+
+# Core dependencies
+protobuf = "6.33.1"  # Pinned for compatibility with kurrentdbclient, OpenTelemetry, and etcd3-py
+apscheduler = "3.11.0"
+pydantic = {extras = ["email"], version = "2.10.3"}
+email-validator = "2.2.0"
+jinja2 = "3.1.4"
+
+# Optional dependencies - install with extras
+redis = { version = "5.2.0", optional = true }
+pymongo = { version = "4.15.4", optional = true }
+motor = { version = "3.7.0", optional = true }
+kurrentdbclient = "1.1.2"
+etcd3-py = { version = "0.1.6", optional = true }  # Maintained fork with protobuf 5.x/6.x support
+
+# OpenTelemetry dependencies - pinned versions for protobuf 6.x compatibility
+opentelemetry-api = "1.38.0"
+opentelemetry-sdk = "1.38.0"
+opentelemetry-exporter-otlp-proto-grpc = "1.38.0"
+opentelemetry-exporter-otlp-proto-http = "1.38.0"
+opentelemetry-instrumentation = "0.59b0"
+opentelemetry-instrumentation-fastapi = "0.59b0"
+opentelemetry-instrumentation-httpx = "0.59b0"
+opentelemetry-instrumentation-logging = "0.59b0"
+opentelemetry-instrumentation-system-metrics = "0.59b0"
+opentelemetry-exporter-prometheus = "0.59b0"  # Prometheus /metrics endpoint support
+prometheus-client = "0.21.0"  # Required by opentelemetry-exporter-prometheus
+boto3 = { version = "1.40.64", optional = true }
+
+[tool.poetry.extras]
+mongodb = ["pymongo", "motor"]
+eventstore = ["kurrentdbclient"]  # Formerly esdbclient
+redis = ["redis"]
+etcd = ["etcd3-py", "protobuf"]
+aws = ["boto3"]
+all = ["pymongo", "motor", "kurrentdbclient", "redis", "etcd3-py", "protobuf", "boto3"]
+
+[tool.poetry.group.dev.dependencies]
+# Development and testing dependencies
+pre-commit = "^4.0.1"
+pytest = "^8.3.3"
+pytest-asyncio = "^0.24.0"
+mypy = "^1.13.0"
+autopep8 = "^2.3.1"
+coverage = "^7.6.9"
+mypy-extensions = "^1.0.0"
+flake8 = "^7.1.1"
+isort = "^5.13.2"
+
+[tool.poetry.group.docs]
+optional = true
+
+[tool.poetry.group.docs.dependencies]
+# Documentation dependencies
+mkdocs = "^1.6.1"
+mkdocs-material = "^9.5.48"
+mkdocs-mermaid2-plugin = "^1.2.2"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.black]
+line-length = 500

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/src/neuroglia/__init__.py

@@ -62,7 +62,7 @@ __all__ = [
 ]
 
 # Framework metadata
-__version__ = "0.6.17"
+__version__ = "0.7.8"
 __author__ = "Neuroglia Team"
 __email__ = "team@neuroglia.io"
 __license__ = "Apache"

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/src/neuroglia/data/infrastructure/event_sourcing/__init__.py

@@ -5,23 +5,29 @@ Provides event store implementations and aggregate root support.
 """
 
 from .abstractions import (
-    EventStore,
-    EventRecord,
+    Aggregator,
     EventDescriptor,
+    EventRecord,
+    EventStore,
+    EventStoreOptions,
     StreamDescriptor,
     StreamReadDirection,
-    EventStoreOptions,
-    Aggregator
 )
 from .event_sourcing_repository import EventSourcingRepository
+from .read_model_reconciliator import (
+    ReadModelConciliationOptions,
+    ReadModelReconciliator,
+)
 
 __all__ = [
     "EventStore",
     "EventSourcingRepository",
     "EventRecord",
-    "EventDescriptor", 
+    "EventDescriptor",
     "StreamDescriptor",
     "StreamReadDirection",
     "EventStoreOptions",
     "Aggregator",
-]
+    "ReadModelConciliationOptions",
+    "ReadModelReconciliator",
+]

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/src/neuroglia/data/infrastructure/event_sourcing/abstractions.py

@@ -202,8 +202,23 @@ class EventStore(ABC):
 
 class Aggregator:
     def aggregate(self, events: list, aggregate_type: type):
+        """
+        Reconstitutes an aggregate from a list of domain events.
+
+        Creates a new aggregate instance using __new__() to bypass __init__,
+        then manually initializes the state and _pending_events list before
+        replaying events to rebuild the aggregate's state.
+
+        Args:
+            events: List of event records to replay
+            aggregate_type: The aggregate root class to instantiate
+
+        Returns:
+            Reconstituted aggregate with replayed state
+        """
         aggregate: AggregateRoot = object.__new__(aggregate_type)
         aggregate.state = aggregate.__orig_bases__[0].__args__[0]()
+        aggregate._pending_events = list()  # Initialize _pending_events to prevent AttributeError
         for e in events:
             aggregate.state.on(e.data)
             aggregate.state.state_version = e.data.aggregate_version

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/src/neuroglia/data/infrastructure/event_sourcing/event_sourcing_repository.py

@@ -113,10 +113,20 @@ class EventSourcingRepository(Generic[TAggregate, TKey], Repository[TAggregate,
         return self._eventstore.contains_stream(self._build_stream_id_for(id))
 
     async def get_async(self, id: TKey) -> Optional[TAggregate]:
-        """Gets the aggregate with the specified id, if any"""
+        """
+        Gets the aggregate with the specified id, if any.
+
+        Returns None if the stream does not exist.
+        """
         stream_id = self._build_stream_id_for(id)
-        events = await self._eventstore.read_async(stream_id, StreamReadDirection.FORWARDS, 0)
-        return self._aggregator.aggregate(events, self.__orig_class__.__args__[0])
+        try:
+            events = await self._eventstore.read_async(stream_id, StreamReadDirection.FORWARDS, 0)
+            if not events:
+                return None
+            return self._aggregator.aggregate(events, self.__orig_class__.__args__[0])
+        except Exception:
+            # If stream doesn't exist or any other error occurs, return None
+            return None
 
     async def _do_add_async(self, aggregate: TAggregate) -> TAggregate:
         """Adds and persists the specified aggregate"""
@@ -127,7 +137,8 @@ class EventSourcingRepository(Generic[TAggregate, TKey], Repository[TAggregate,
         encoded_events = [self._encode_event(e) for e in events]
         await self._eventstore.append_async(stream_id, encoded_events)
         aggregate.state.state_version = events[-1].aggregate_version
-        aggregate.clear_pending_events()
+        # DON'T clear pending events here - let base class do it after publishing!
+        # aggregate.clear_pending_events()
         return aggregate
 
     async def _do_update_async(self, aggregate: TAggregate) -> TAggregate:
@@ -139,7 +150,8 @@ class EventSourcingRepository(Generic[TAggregate, TKey], Repository[TAggregate,
         encoded_events = [self._encode_event(e) for e in events]
         await self._eventstore.append_async(stream_id, encoded_events, aggregate.state.state_version)
         aggregate.state.state_version = events[-1].aggregate_version
-        aggregate.clear_pending_events()
+        # DON'T clear pending events here - let base class do it after publishing!
+        # aggregate.clear_pending_events()
         return aggregate
 
     async def _do_remove_async(self, id: TKey) -> None:

{neuroglia_python-0.6.17 → neuroglia_python-0.7.8}/src/neuroglia/data/infrastructure/event_sourcing/event_store/event_store.py

@@ -5,9 +5,9 @@ import sys
 from typing import Any, Dict, Optional
 
 import rx
-from esdbclient import AsyncioEventStoreDBClient as AsyncClientFactory
-from esdbclient import NewEvent, RecordedEvent, StreamState
-from esdbclient.exceptions import AlreadyExists
+from kurrentdbclient import AsyncKurrentDBClient as AsyncClientFactory
+from kurrentdbclient import NewEvent, RecordedEvent, StreamState
+from kurrentdbclient.exceptions import AlreadyExistsError as AlreadyExists
 from rx.core.observable.observable import Observable
 from rx.disposable.disposable import Disposable
 from rx.subject.subject import Subject
@@ -64,11 +64,15 @@ class ESEventStore(EventStore):
             self._eventstore_client = connection_string_or_client
 
     async def _ensure_client(self) -> Any:
-        """Lazily initialize the async EventStoreDB client on first use"""
+        """Lazily initialize the async KurrentDB client on first use"""
         if self._eventstore_client is None:
             if self._connection_string is None:
                 raise RuntimeError("Neither connection string nor client provided")
-            self._eventstore_client = await AsyncClientFactory(uri=self._connection_string)
+            # AsyncKurrentDBClient constructor is NOT awaitable - returns client directly
+            client = AsyncClientFactory(uri=self._connection_string)
+            # Must call connect() to establish the connection
+            await client.connect()
+            self._eventstore_client = client
         return self._eventstore_client
 
     async def contains_async(self, stream_id: str) -> bool:
@@ -101,7 +105,7 @@ class ESEventStore(EventStore):
             return None
         truncate_before = metadata.get("$tb")
         offset = 0 if truncate_before is None else truncate_before
-        read_response = client.read_stream(
+        read_response = await client.read_stream(
             stream_name=stream_name,
             stream_position=offset,
             backwards=False,
@@ -109,7 +113,7 @@ class ESEventStore(EventStore):
             limit=1,
         )
         recorded_events = [event async for event in read_response]
-        read_response = client.read_stream(
+        read_response = await client.read_stream(
             stream_name=stream_name,
             stream_position=offset,
             backwards=True,
@@ -131,7 +135,7 @@ class ESEventStore(EventStore):
     ) -> list[EventRecord]:
         client = await self._ensure_client()
         stream_name = self._get_stream_name(stream_id)
-        read_response = client.read_stream(
+        read_response = await client.read_stream(
             stream_name=stream_name,
             stream_position=offset,
             backwards=True if read_direction == StreamReadDirection.BACKWARDS else False,
@@ -253,7 +257,9 @@ class ESEventStore(EventStore):
                     logging.debug(f"Skipping tombstone event from stream: {e.stream_name}")
                     # Acknowledge tombstone to continue processing
                     if is_persistent:
-                        await subscription.ack(e.id)
+                        # Use ack_id for resolved link events, fall back to id
+                        ack_id = getattr(e, "ack_id", e.id)
+                        await subscription.ack(ack_id)
                     continue
 
                 # Skip system event types (prefixed with $)
@@ -262,7 +268,9 @@ class ESEventStore(EventStore):
                     logging.debug(f"Skipping system event type '{e.type}' from stream: {e.stream_name}")
                     # Acknowledge system event to continue processing
                     if is_persistent:
-                        await subscription.ack(e.id)
+                        # Use ack_id for resolved link events, fall back to id
+                        ack_id = getattr(e, "ack_id", e.id)
+                        await subscription.ack(ack_id)
                     continue
 
                 try:
@@ -271,12 +279,16 @@ class ESEventStore(EventStore):
                     logging.warning(f"Could not decode event with offset '{e.stream_position}' from stream '{e.stream_name}': {ex}")
                     # Acknowledge failed decode to continue processing (don't park/retry invalid events)
                     if is_persistent:
-                        await subscription.ack(e.id)
+                        # Use ack_id for resolved link events, fall back to id
+                        ack_id = getattr(e, "ack_id", e.id)
+                        await subscription.ack(ack_id)
                     continue
 
                 # Convert to AckableEventRecord if subscription supports ack/nack
                 if is_persistent:
-                    event_id = e.id
+                    # Use ack_id for resolved link events (resolveLinktos=true), fall back to id
+                    # This is critical for persistent subscriptions to category streams ($ce-*)
+                    event_id = getattr(e, "ack_id", e.id)
 
                     async def ack_delegate(eid=event_id, sub=subscription):
                         """