python-neva 3.3.0__py3-none-any.whl → 3.4.0__py3-none-any.whl

neva/arch/service_provider.py

@@ -175,6 +175,10 @@ class ServiceProvider(abc.ABC):
         _ = self.provider.decorate(source, provides=interface, scope=scope, when=when)
         return self
 
+    def from_context(self, interface: type, scope: Scope | None = None) -> None:
+        """Declares an interface as provided by the current context."""
+        _ = self.provider.from_context(provides=interface, scope=scope)
+
     @abc.abstractmethod
     def register(self) -> Result[Self, str]:
         """Register services into the application container.

neva/events/contracts/__init__.py

@@ -1,7 +1,20 @@
-from neva.events.contracts.dispatcher import EventDispatcher
+from neva.events.contracts.dispatcher import (
+    AsyncBeforeDispatchHook,
+    BeforeDispatchHook,
+    EventDispatcher,
+    SyncBeforeDispatchHook,
+)
 from neva.events.contracts.event import Event
 from neva.events.contracts.handler import EventHandler
 from neva.events.contracts.listener import EventListener
 
 
-__all__ = ["Event", "EventDispatcher", "EventHandler", "EventListener"]
+__all__ = [
+    "AsyncBeforeDispatchHook",
+    "BeforeDispatchHook",
+    "Event",
+    "EventDispatcher",
+    "EventHandler",
+    "EventListener",
+    "SyncBeforeDispatchHook",
+]

neva/events/contracts/dispatcher.py

@@ -1,10 +1,29 @@
-from typing import Protocol
+from typing import Protocol, runtime_checkable
 
 from neva.events.contracts.event import Event
 from neva.events.contracts.listener import EventListener
 from neva.support import Result
 
 
+@runtime_checkable
+class AsyncBeforeDispatchHook(Protocol):
+    """Asynchronous hook to be called before listeners are invoked."""
+
+    async def __call__(self, context: Event) -> None:
+        """Execute the hook."""
+
+
+@runtime_checkable
+class SyncBeforeDispatchHook(Protocol):
+    """Synchronous hook to be called before listeners are invoked."""
+
+    def __call__(self, context: Event) -> None:
+        """Execute the hook."""
+
+
+BeforeDispatchHook = AsyncBeforeDispatchHook | SyncBeforeDispatchHook
+
+
 class EventDispatcher(Protocol):
     """Event dispatcher protocol."""
 
@@ -15,6 +34,10 @@ class EventDispatcher(Protocol):
         """Dispatch an event to all registered listeners."""
         ...
 
+    async def before_dispatch(self, hook: BeforeDispatchHook) -> None:
+        """Register a hook to be called before listeners are invoked."""
+        ...
+
     def listen[T: Event](
         self,
         event_cls: type[T],

neva/events/dispatcher.py

@@ -1,6 +1,6 @@
 """Base implementation of the event dispatcher."""
 
-from typing import Callable, Protocol, override, runtime_checkable
+from typing import override
 
 from neva.arch.application import Application
 from neva.database.manager import DatabaseManager
@@ -10,19 +10,6 @@ from neva.events.event_registry import EventRegistry
 from neva.support import Err, Nothing, Result, Some
 
 
-@runtime_checkable
-class AsyncBeforeDispatchHook(Protocol):
-    async def __call__(self, context: contracts.Event) -> None: ...
-
-
-@runtime_checkable
-class SyncBeforeDispatchHook(Protocol):
-    def __call__(self, context: contracts.Event) -> None: ...
-
-
-BeforeDispatchHook = AsyncBeforeDispatchHook | SyncBeforeDispatchHook
-
-
 class EventDispatcher(contracts.EventDispatcher):
     """Event dispatcher implementation."""
 
@@ -35,7 +22,7 @@ class EventDispatcher(contracts.EventDispatcher):
         self._registry: EventRegistry = registry
         self._app: Application = app
         self._db: DatabaseManager = db
-        self._before_dispatch_hooks: list[BeforeDispatchHook] = []
+        self._before_dispatch_hooks: list[contracts.BeforeDispatchHook] = []
 
     async def _apply_before_dispatch(self, event: contracts.Event) -> None:
         """Extension hook called before listeners are invoked.
@@ -49,12 +36,13 @@ class EventDispatcher(contracts.EventDispatcher):
         """
         for hook in self._before_dispatch_hooks:
             match hook:
-                case AsyncBeforeDispatchHook():
+                case contracts.AsyncBeforeDispatchHook():
                     await hook(event)
-                case SyncBeforeDispatchHook():
+                case contracts.SyncBeforeDispatchHook():
                     hook(event)
 
-    async def before_dispatch(self, hook: BeforeDispatchHook) -> None:
+    @override
+    async def before_dispatch(self, hook: contracts.BeforeDispatchHook) -> None:
         """Register a hook to be called before listeners are invoked."""
         self._before_dispatch_hooks.append(hook)
 

neva/support/facade/event.pyi

@@ -2,9 +2,8 @@
 
 from typing import override
 
-from neva import events
 from neva.arch import Facade
-from neva.events import EventListener
+from neva.events import contracts
 from neva.support import Result
 
 class Event(Facade):
@@ -14,10 +13,10 @@ class Event(Facade):
     @override
     def get_facade_accessor(cls) -> type: ...
     @classmethod
-    async def dispatch(cls, event: events.Event) -> list[Result[None, str]]: ...
+    async def dispatch(cls, event: contracts.Event) -> list[Result[None, str]]: ...
     @classmethod
-    def listen[T: events.Event](
+    def listen[T: contracts.Event](
         cls,
         event_cls: type[T],
-        listener_cls: type[EventListener[T]],
+        listener_cls: type[contracts.EventListener[T]],
     ) -> None: ...

neva/testing/fakes.py

@@ -1,19 +1,20 @@
 """Testing fakes for Neva facades."""
 
 from collections.abc import Callable
-from typing import Any
+from typing import override
 
-from neva.events.event import Event as BaseEvent
+from neva.events import contracts
 from neva.support import Result
 
 
-class EventFake:
+class EventFake(contracts.EventDispatcher):
     """Recording fake for the Event facade. No listeners are dispatched."""
 
     def __init__(self) -> None:
-        self._dispatched: list[BaseEvent[Any]] = []
+        self._dispatched: list[contracts.Event] = []
 
-    async def dispatch(self, event: BaseEvent[Any]) -> list[Result[None, str]]:
+    @override
+    async def dispatch(self, event: contracts.Event) -> list[Result[None, str]]:
         """Record the event without invoking any listeners.
 
         Returns:
@@ -22,10 +23,17 @@ class EventFake:
         self._dispatched.append(event)
         return []
 
-    def listen[T: BaseEvent[Any]](self, event_cls: type[T], listener_cls: type) -> None:
+    @override
+    def listen[T: contracts.Event](
+        self, event_cls: type[T], listener_cls: type[contracts.EventListener[T]]
+    ) -> None:
         """No-op."""
 
-    def dispatched[E: BaseEvent[Any]](self, event_cls: type[E]) -> list[E]:
+    @override
+    async def before_dispatch(self, hook: contracts.BeforeDispatchHook) -> None:
+        """Register a hook to be called before listeners are invoked."""
+
+    def dispatched[E: contracts.Event](self, event_cls: type[E]) -> list[E]:
         """Return all recorded events of the given type.
 
         Returns:
@@ -33,7 +41,7 @@ class EventFake:
         """
         return [e for e in self._dispatched if isinstance(e, event_cls)]
 
-    def assert_dispatched[E: BaseEvent[Any]](
+    def assert_dispatched[E: contracts.Event](
         self,
         event_cls: type[E],
         *,
@@ -61,7 +69,7 @@ class EventFake:
         if match is not None and not any(match(e) for e in matching):
             raise AssertionError(f"No {event_cls.__name__} matched the predicate")
 
-    def assert_not_dispatched[E: BaseEvent[Any]](self, event_cls: type[E]) -> None:
+    def assert_not_dispatched[E: contracts.Event](self, event_cls: type[E]) -> None:
         """Assert that no event of the given type was dispatched.
 
         Args:

{python_neva-3.3.0.dist-info → python_neva-3.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-neva
-Version: 3.3.0
+Version: 3.4.0
 Summary: Add your description here
 Requires-Python: >=3.12
 Requires-Dist: aiosqlite>=0.20.0

{python_neva-3.3.0.dist-info → python_neva-3.4.0.dist-info}/RECORD

@@ -5,7 +5,7 @@ neva/arch/facade.py,sha256=1kYVhyYto8zSyOZV6sAYJ3xWzQDJRzoVV-e_EarTp0Q,7927
 neva/arch/markers.py,sha256=STdhmW88qV8uogIa9kSD9gs-uMRaglZI8HOw3PrhX1Q,103
 neva/arch/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neva/arch/scopes.py,sha256=Gu0kJk39Yv8LCCzxjdu0lIE0FXtnsG36LGKDuNin2CE,87
-neva/arch/service_provider.py,sha256=zEFwix2cL6l1Frv9w1OMtnL_zjkl_BVpGBhRaNK6bb0,5636
+neva/arch/service_provider.py,sha256=SqL3uQGBh7aDIc_Lcp8Ijr3fdOtB8wbsmMnjU4GuUy4,5862
 neva/arch/integrations/__init__.py,sha256=cXuqC4JfZdGYLlh6POgYUVXUT2NQ84276eC-RYTyFxk,75
 neva/arch/integrations/faststream.py,sha256=AOwfpfdL3O5HLAx80SwUGQb_hKEeAkFOUyIXtjODaHM,1696
 neva/config/__init__.py,sha256=Ygfnh-MRRKYDdf54_LeMSHwmck5VpNHTdnnMtGEFLtU,121
@@ -21,15 +21,15 @@ neva/database/provider.py,sha256=l2be4Ri53RtQq1-qzohy3cqzJQpTaNzqXGVhXPKUCXc,167
 neva/database/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neva/database/transaction.py,sha256=_0Dsao_vhCJT5YRUmrHOLb0uxvfdE-5k3n0yMPLC1o8,5167
 neva/events/__init__.py,sha256=Gpi5q-pNlIi-q23U2ZOsNf8Y9rB6AQtsBbbBFU0tkFc,776
-neva/events/dispatcher.py,sha256=fFhF39sba1VOiwLa2eHzib5qWk4n_SOoWiYkmZL044o,4686
+neva/events/dispatcher.py,sha256=5M8s3aVzx9lIViGkigtu1kq6gFbam4OKDajuWNGuqA0,4376
 neva/events/event.py,sha256=q-KyyxNkU3AN2YSaujuNPIoXQMXhGOwClTap5y8fU5I,282
 neva/events/event_registry.py,sha256=IZnpR3oLyvt5K2pn9KMCBw5W4JP7Ok_zMKI2SgQoXVM,1945
 neva/events/listener.py,sha256=2d5RHVKO0pU-eL_evLReTG0DIoX9tZyOcn8PWLeECZo,1435
 neva/events/policy.py,sha256=I67ziob0IEVeXdkilNPpj2f48gEz2EZneR1Fz8Nlt2U,154
 neva/events/provider.py,sha256=cVxADLv7VXCK6gTMJsDNRzspMOH2lrIkvMRhqVh2cK4,954
 neva/events/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-neva/events/contracts/__init__.py,sha256=6-xRFR_5t6PbU-owl0WtM8mmdvmNvuHPUyL1sbFfqU8,293
-neva/events/contracts/dispatcher.py,sha256=jJ4qLM_5-bXcBPH_txnbwHXAs6GFB080MiDkEViatTk,594
+neva/events/contracts/__init__.py,sha256=t1VafYtzOZIF78V8X3K_Fg79Hw4FjSqasjLs0EQVIFA,489
+neva/events/contracts/dispatcher.py,sha256=pzCv_ZLS5ju2IKVMxL5f-fFipEqQZc6zPiIVtJhKJHc,1274
 neva/events/contracts/event.py,sha256=kUUECex_AlmaPJ-fXRg32eMkiqNS75CHldOr7bbpFqo,89
 neva/events/contracts/handler.py,sha256=SwLuuRtXhCzGkcBBLdH3MjUAkjEr0_rhqgE6dkWVJxI,327
 neva/events/contracts/listener.py,sha256=0xwPrjprkMzXu9vY1Z-EjSLFdvOUpomiE65hH16nfxA,465
@@ -81,16 +81,16 @@ neva/support/facade/crypt.pyi,sha256=_MV_qXDATaCs1pZTOw_-qPx_jjH_nG4-tUBOMX4nZIE
 neva/support/facade/db.py,sha256=mXMzuCKf390ICCBgzaub1ZoMqUBgOQByQYMEM3YnN_0,324
 neva/support/facade/db.pyi,sha256=UQFMgBuw0BGquMnuUNULC8Pdo7lDCVTCNkDaUmIZJhw,1911
 neva/support/facade/event.py,sha256=sRU-fxaRT59Fe-u2WTS5L9ncGkGLBndKa9gKbqwAq3M,1232
-neva/support/facade/event.pyi,sha256=wI1NlIg8p6j9jispsA6pI-kvNp81nwUM3ZP8O0zFaHk,558
+neva/support/facade/event.pyi,sha256=AL_v8fxkvtd9KwbiWbVuUAcdZz0yzLn8xZROFa6lXLE,546
 neva/support/facade/hash.py,sha256=tGhsvfGovt-mcRXSjDKf4jt1n7ib0eDPXFvRUfVxLUc,292
 neva/support/facade/hash.pyi,sha256=jTs3E5ZF5cp76jrgH70DEog8gzfYIcIV2PrO9xskHyI,1656
 neva/support/facade/log.py,sha256=_uLoHB9tkpHkiqEJXazbaqfiKUOtv3NS71ZCZAprzOI,347
 neva/support/facade/log.pyi,sha256=Xi7gIzw9qRqmD4D3PcW06_HUtgLWEOdsHqs1B0jh1-k,1647
 neva/testing/__init__.py,sha256=vt5zxG1N84vn_YwP44jhYPWYnyb02-cha3m-1l-qoEw,207
-neva/testing/fakes.py,sha256=5HuuwMeAKhFSZfn9T8raQIjdgHkjFeZsFXDud0T4v7Q,2674
+neva/testing/fakes.py,sha256=w2dnFaO6x14l0_si7iBNELMCxaFi8VsVOSQ6PmTlclE,2936
 neva/testing/fixtures.py,sha256=oiPa5ntUkW-SbySDvwEHXtti8NqSwI-R0CT1_ezTx_Y,1445
 neva/testing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neva/testing/test_case.py,sha256=zJBZJeKI-sv-EOaXNuSJ0V2Zp_6hdk64W4dOh0eP8RI,3290
-python_neva-3.3.0.dist-info/METADATA,sha256=7J-vn_EdbJAX-DgR0zsWf8NWVIq2BPd5Fp5YYiZcbic,846
-python_neva-3.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-python_neva-3.3.0.dist-info/RECORD,,
+python_neva-3.4.0.dist-info/METADATA,sha256=rW3P72J2ukVUItHYsF1EDWCu4SJzGqv--6PjnYDnO5o,846
+python_neva-3.4.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+python_neva-3.4.0.dist-info/RECORD,,