python-neva 3.3.0__tar.gz → 3.4.0__tar.gz

python_neva-3.4.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+## 3.4.0 (2026-06-10)
+
+### ✨ Features
+
+- **arch**: new from_context method
+- **tooling**: placeholder commit
+
+### 💚👷 CI & Build
+
+- **tooling**: default to base tag version for commitizen
+
+### 📝💡 Documentation
+
+- **project**: update doc
+- **core**: placeholde readme
+
+### 🔧🔨📦️ Configuration, Scripts, Packages
+
+- **tooling**: update changelog script
+- **project**: update versioning config

{python_neva-3.3.0 → python_neva-3.4.0}/PKG-INFO

@@ -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 → python_neva-3.4.0}/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.

python_neva-3.4.0/neva/events/contracts/__init__.py

@@ -0,0 +1,20 @@
+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__ = [
+    "AsyncBeforeDispatchHook",
+    "BeforeDispatchHook",
+    "Event",
+    "EventDispatcher",
+    "EventHandler",
+    "EventListener",
+    "SyncBeforeDispatchHook",
+]

python_neva-3.4.0/neva/events/contracts/dispatcher.py

@@ -0,0 +1,47 @@
+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."""
+
+    async def dispatch(
+        self,
+        event: Event,
+    ) -> list[Result[None, str]]:
+        """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],
+        listener_cls: type[EventListener[T]],
+    ) -> None:
+        """Register a listener for an event."""
+        ...

{python_neva-3.3.0 → python_neva-3.4.0}/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)
 

{python_neva-3.3.0 → python_neva-3.4.0}/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: ...

{python_neva-3.3.0 → python_neva-3.4.0}/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 → python_neva-3.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-neva"
-version = "3.3.0"
+version = "3.4.0"
 description = "Add your description here"
 readme = "README.md"
 requires-python = ">=3.12"

python_neva-3.4.0/tests/arch/test_context.py

@@ -0,0 +1,60 @@
+from pathlib import Path
+from typing import Self, override
+
+
+from neva import arch
+from neva.arch.scopes import Scope
+from neva.support import Ok, Result
+from neva.support.facade import Log
+from neva.testing import TestCase
+
+
+class RequestService:
+    """A service scoped to REQUEST."""
+
+    def __init__(self) -> None:
+        self.value: int = id(self)
+
+
+class RequestScopedProvider(arch.ServiceProvider):
+    """Registers a REQUEST-scoped service."""
+
+    @override
+    def register(self) -> Result[Self, str]:
+        self.from_context(RequestService, scope=Scope.REQUEST)
+        return Ok(self)
+
+
+def _make_config_dir(tmp_path: Path) -> Path:
+    config_dir = tmp_path / "config"
+    config_dir.mkdir()
+
+    _ = (config_dir / "app.py").write_text(
+        'config = {"name": "TestApp", "debug": True}'
+    )
+    _ = (config_dir / "providers.py").write_text(
+        """
+from tests.arch.test_context import RequestScopedProvider
+
+config = {"providers": [RequestScopedProvider]}
+"""
+    )
+
+    return config_dir
+
+
+class TestScopeEntersChildScope(TestCase):
+    @override
+    def create_config(self, tmp_path: Path) -> Path:
+        return _make_config_dir(tmp_path)
+
+    async def test_request_scoped_service_resolved_in_scope(self) -> None:
+        test_service = RequestService()
+        async with self.app.scope(
+            scope=Scope.REQUEST,
+            context={RequestService: test_service},
+        ):
+            new_service_result = self.app.make(RequestService)
+            new_service = new_service_result.unwrap()
+
+            assert new_service.value == test_service.value

{python_neva-3.3.0 → python_neva-3.4.0}/tests/arch/test_extends.py

@@ -1,4 +1,3 @@
-from dataclasses import dataclass
 import uuid
 from datetime import datetime
 from pathlib import Path

{python_neva-3.3.0 → python_neva-3.4.0}/uv.lock

@@ -1733,7 +1733,7 @@ wheels = [
 
 [[package]]
 name = "python-neva"
-version = "3.3.0"
+version = "3.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "aiosqlite" },

python_neva-3.3.0/CHANGELOG.md

@@ -1,115 +0,0 @@
-## 3.3.0 (2026-06-05)
-
-### ✨ Features
-
-- **tooling**: placeholder commit
-
-### 💚👷 CI & Build
-
-- **tooling**: default to base tag version for commitizen
-
-### 📝💡 Documentation
-
-- **project**: update doc
-- **core**: placeholde readme
-
-### 🔧🔨📦️ Configuration, Scripts, Packages
-
-- **tooling**: update changelog script
-- **project**: update versioning config
-
-## 3.2.0 (2026-06-05)
-
-### ✨ Features
-
-- **tooling**: placeholder commit
-
-### 🔧🔨📦️ Configuration, Scripts, Packages
-
-- **tooling**: update changelog script
-- **project**: update versioning config
-
-### 📝💡 Documentation
-
-- **core**: placeholde readme
-
-## 3.1.1 (2026-05-11)
-
-### 📌➕⬇️➖⬆️ Dependencies
-
-- bump opt dep on neva-fastapi
-
-## 3.1.0 (2026-05-11)
-
-### ✨ Features
-
-- fixing db facade
-- Add eq method to Some / Ok
-- Deprecate register_engine, add register_connection
-- RefreshDatabase now properly use the testcase inner app
-- Add neva-fastapi as optional dependency
-- renaming of make / make_async for retrocompatibility
-
-### 🐛🚑️ Fixes
-
-- Fix provider registration ordering
-
-### ♻️ Refactorings
-
-- refactor of results / db toolkit
-
-## 3.1.0a1 (2026-05-05)
-
-### build
-
-- add commitizen + versioningit
-
-### 💚👷 CI & Build
-
-- update perms on tag script
-- tweaking cz tags
-- remove auto-annotated tags
-- configure versioningit + cz
-- Fix cz config >>> ⏰ 1
-- add and configure cz_gitmoji >>> ⏰ 5m
-
-### 📝💡 Documentation
-
-- clear changelog
-
-### 🔧🔨📦️ Configuration, Scripts, Packages
-
-- improve auto-annotation of tags
-- Fix tagging script
-
-## python-neva-v3.2.0 (2026-06-04)
-
-### ✨ Features
-
-- **core**: add optional activator on all binding functions
-- **core**: remove scoping option from scoped, default to request scope
-- **core**: introduce conditional activation
-- **core**: add specifying interface in extends method
-- **core**: add extends feature
-
-### build
-
-- **core**: remove redundant .envrc files
-- **core**: fixing version derivation
-
-### docs
-
-- **core,-fastapi**: add contributing documentation
-
-### feat
-
-- **core**: allow passing context data to scope method
-- **core**: add some utility functions for binding
-- **core**: add some utility functions for binding
-- **core**: add the possibility to turn off dependency caching
-- **core,-fastapi**: add .envrc file
-
-### refactor
-
-- **core**: cleaning up type hints
-- **core**: update type hints on main application

python_neva-3.3.0/neva/events/contracts/__init__.py

@@ -1,7 +0,0 @@
-from neva.events.contracts.dispatcher import EventDispatcher
-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"]

python_neva-3.3.0/neva/events/contracts/dispatcher.py

@@ -1,24 +0,0 @@
-from typing import Protocol
-
-from neva.events.contracts.event import Event
-from neva.events.contracts.listener import EventListener
-from neva.support import Result
-
-
-class EventDispatcher(Protocol):
-    """Event dispatcher protocol."""
-
-    async def dispatch(
-        self,
-        event: Event,
-    ) -> list[Result[None, str]]:
-        """Dispatch an event to all registered listeners."""
-        ...
-
-    def listen[T: Event](
-        self,
-        event_cls: type[T],
-        listener_cls: type[EventListener[T]],
-    ) -> None:
-        """Register a listener for an event."""
-        ...