python-neva 3.3.0__py3-none-any.whl → 3.5.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,7 @@
 """Base implementation of the event dispatcher."""
 
-from typing import Callable, Protocol, override, runtime_checkable
+import inspect
+from typing import override
 
 from neva.arch.application import Application
 from neva.database.manager import DatabaseManager
@@ -10,19 +11,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 +23,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.
@@ -48,13 +36,12 @@ class EventDispatcher(contracts.EventDispatcher):
             event: The event about to be dispatched.
         """
         for hook in self._before_dispatch_hooks:
-            match hook:
-                case AsyncBeforeDispatchHook():
-                    await hook(event)
-                case SyncBeforeDispatchHook():
-                    hook(event)
+            result = hook(event)
+            if inspect.isawaitable(result):
+                await result
 
-    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/app.pyi

@@ -1,14 +1,24 @@
 """Type stub for App facade."""
 
-from typing import override
+from contextlib import AbstractAsyncContextManager
+from typing import Any, Self, override
 
 from neva.arch import Facade
+from neva.arch.scopes import BaseScope
 from neva.support import Result
 
 class App(Facade):
     @classmethod
     @override
     def get_facade_accessor(cls) -> type: ...
+    @classmethod
+    async def make_async[T](cls, interface: type[T]) -> Result[T, str]:
+        """Resolve and instanciate a type from the container.
+
+        Returns:
+            Result containing the resolved type instance or an error message.
+        """
+
     @classmethod
     def make[T](cls, interface: type[T]) -> Result[T, str]:
         """Resolve an interface from the container by its alias.
@@ -23,3 +33,15 @@ class App(Facade):
             Result containing the resolved service instance or an error message.
 
         """
+
+    @classmethod
+    async def scope(
+        cls,
+        scope: BaseScope | None = None,
+        context: dict[type, Any] | None = None,
+    ) -> AbstractAsyncContextManager[Self]:
+        """Enter a new scope.
+
+        Yields:
+            The application instance with the new scope.
+        """

neva/support/facade/event.py

@@ -5,7 +5,7 @@ from contextlib import contextmanager
 from typing import TYPE_CHECKING, override
 
 from neva.arch import Facade
-from neva.events import EventDispatcher
+from neva.events import contracts
 
 
 if TYPE_CHECKING:
@@ -23,7 +23,7 @@ class Event(Facade):
         Returns:
             EventDispatcher class.
         """
-        return EventDispatcher
+        return contracts.EventDispatcher
 
     @classmethod
     def fake(cls) -> "EventFake":

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,15 @@ class Event(Facade):
     @override
     def get_facade_accessor(cls) -> type: ...
     @classmethod
-    async def dispatch(cls, event: events.Event) -> list[Result[None, str]]: ...
+    async def before_dispatch(cls, hook: contracts.BeforeDispatchHook) -> None:
+        """Register a hook to be called before listeners are invoked."""
     @classmethod
-    def listen[T: events.Event](
+    async def dispatch(cls, event: contracts.Event) -> list[Result[None, str]]:
+        """Dispatch an event to all registered listeners."""
+    @classmethod
+    def listen[T: contracts.Event](
         cls,
         event_cls: type[T],
-        listener_cls: type[EventListener[T]],
-    ) -> None: ...
+        listener_cls: type[contracts.EventListener[T]],
+    ) -> None:
+        """Register a listener for an event."""

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.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-neva
-Version: 3.3.0
+Version: 3.5.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.5.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=KR5uDZbnNwrMCI6s9S_SoNrNHx2z2lugoHk1-g3fzXA,4288
 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
@@ -73,24 +73,24 @@ neva/support/strconv.py,sha256=cvYRtJVG3IuhQzZCqJD1nVm3g0wxRu-IIIFK16Mq7d8,1296
 neva/support/time.py,sha256=QYH1F38V33F1C-rlH1Xbrblnaue1-BnercFYUBMmq88,351
 neva/support/facade/__init__.py,sha256=aysM4AyDAxAgv8uZCka49t2vLHeVraTNAHeCIpXLd-s,465
 neva/support/facade/app.py,sha256=xdL9qpeQnJtAMomxfrImM82qM2YV2eQFsckmUNE2w7I,297
-neva/support/facade/app.pyi,sha256=QBk-1cRpcNPsxQM0cGT0IYU1B4DQeExhzf1w8Sbax2g,643
+neva/support/facade/app.pyi,sha256=gTAKp_r8DUqOj-oggAyAuK1WvR2AzX63-G2U5NixHbM,1304
 neva/support/facade/config.py,sha256=cqmtwAekHE4qWH2LqzmY3BAbyAadvZYfPgLHyTcCnJE,358
 neva/support/facade/config.pyi,sha256=LpI6xwqURRlWPcohXBxTL-iWTHq3MMMNdu670Q_5jnk,2549
 neva/support/facade/crypt.py,sha256=BUx2woDla3TrvVOVRNzOg97zfCaXIOqIz5EdoN3BvlA,298
 neva/support/facade/crypt.pyi,sha256=_MV_qXDATaCs1pZTOw_-qPx_jjH_nG4-tUBOMX4nZIE,857
 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.py,sha256=BkJoof1hYTxhMBOxLrq21NIgEPIiLBlj18Pttl0FHa8,1236
+neva/support/facade/event.pyi,sha256=7R6osyTZbHt_zkCfQ-uZnTLfyZTeN1bi3exsgl3-36k,817
 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.5.0.dist-info/METADATA,sha256=rcHS4PoUAyXqpkmfej_UhyUaBgnb5dV-x8ZbwMWbXFQ,846
+python_neva-3.5.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+python_neva-3.5.0.dist-info/RECORD,,