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

neva/database/connection.py

@@ -95,7 +95,7 @@ class ConnectionManager:
 
     @asynccontextmanager
     async def _scoped(self, tx: BoundTransaction) -> AsyncIterator[None]:
-        """Manage registry, state transitions, and callbacks for a transaction.
+        """Expose the transaction on the registry for the duration of the block.
 
         Yields:
             None
@@ -108,40 +108,37 @@ class ConnectionManager:
         )
         try:
             yield
-            if tx.rollback_requested:
-                tx.state = TransactionState.ROLLED_BACK
-                if tx.is_root:
-                    for result in await tx.execute_on_rollback_callbacks():
-                        if result.is_err and self.logger is not None:
-                            self.logger.error(
-                                "rollback callback failed",
-                                error=result.err().unwrap(),
-                                connection=self.name,
-                            )
-            else:
-                tx.state = TransactionState.COMMITTED
-                if tx.is_root:
-                    for result in await tx.execute_on_commit_callbacks():
-                        if result.is_err and self.logger is not None:
-                            self.logger.error(
-                                "commit callback failed",
-                                error=result.err().unwrap(),
-                                connection=self.name,
-                            )
-        except BaseException:
-            tx.state = TransactionState.ROLLED_BACK
-            if tx.is_root:
-                for result in await tx.execute_on_rollback_callbacks():
-                    if result.is_err and self.logger is not None:
-                        self.logger.error(
-                            "rollback callback failed",
-                            error=result.err().unwrap(),
-                            connection=self.name,
-                        )
-            raise
         finally:
             _tx_registry.reset(token)
 
+    async def _settle(self, tx: BoundTransaction, *, committed: bool) -> None:
+        """Mark the transaction settled and drain its callbacks.
+
+        Callers must have already committed or rolled back the underlying
+        session: callbacks observe a settled transaction, and the registry no
+        longer exposes it, so a callback touching the database opens its own
+        transaction rather than reusing the drained one.
+        """
+        tx.state = (
+            TransactionState.COMMITTED if committed else TransactionState.ROLLED_BACK
+        )
+        if not tx.is_root:
+            return
+
+        results = (
+            await tx.execute_on_commit_callbacks()
+            if committed
+            else await tx.execute_on_rollback_callbacks()
+        )
+        label = "commit" if committed else "rollback"
+        for result in results:
+            if result.is_err and self.logger is not None:
+                self.logger.error(
+                    f"{label} callback failed",
+                    error=result.err().unwrap(),
+                    connection=self.name,
+                )
+
     @asynccontextmanager
     async def begin(self) -> AsyncIterator[BoundTransaction]:
         """Open a new bound transaction with an active database session.
@@ -162,23 +159,27 @@ class ConnectionManager:
                 try:
                     async with self._scoped(tx):
                         yield tx
-                    if tx.rollback_requested:
-                        await sp.rollback()
-                    else:
-                        await sp.commit()
+                        if tx.rollback_requested:
+                            await sp.rollback()
+                        else:
+                            await sp.commit()
                 except BaseException:
                     await sp.rollback()
+                    await self._settle(tx, committed=False)
                     raise
+                await self._settle(tx, committed=not tx.rollback_requested)
             case _:
                 async with self.session_factory() as session:
                     tx = BoundTransaction(self.name, session)
                     try:
                         async with self._scoped(tx):
                             yield tx
-                        if tx.rollback_requested:
-                            await session.rollback()
-                        else:
-                            await session.commit()
+                            if tx.rollback_requested:
+                                await session.rollback()
+                            else:
+                                await session.commit()
                     except BaseException:
                         await session.rollback()
+                        await self._settle(tx, committed=False)
                         raise
+                    await self._settle(tx, committed=not tx.rollback_requested)

neva/events/dispatcher.py

@@ -1,5 +1,6 @@
 """Base implementation of the event dispatcher."""
 
+import inspect
 from typing import override
 
 from neva.arch.application import Application
@@ -35,11 +36,9 @@ class EventDispatcher(contracts.EventDispatcher):
             event: The event about to be dispatched.
         """
         for hook in self._before_dispatch_hooks:
-            match hook:
-                case contracts.AsyncBeforeDispatchHook():
-                    await hook(event)
-                case contracts.SyncBeforeDispatchHook():
-                    hook(event)
+            result = hook(event)
+            if inspect.isawaitable(result):
+                await result
 
     @override
     async def before_dispatch(self, hook: contracts.BeforeDispatchHook) -> None:

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

@@ -13,10 +13,15 @@ class Event(Facade):
     @override
     def get_facade_accessor(cls) -> type: ...
     @classmethod
-    async def dispatch(cls, event: contracts.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
+    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[contracts.EventListener[T]],
-    ) -> None: ...
+    ) -> None:
+        """Register a listener for an event."""

python_neva-3.5.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.5
+Name: python-neva
+Version: 3.5.1
+Summary: Add your description here
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: cryptography>=46.0.3
+Requires-Dist: dishka>=1.10.0
+Requires-Dist: fastapi[all]>=0.129.0
+Requires-Dist: faststream>=0.6.6
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.62b0
+Requires-Dist: pwdlib[argon2,bcrypt]>=0.3.0
+Requires-Dist: pyinstrument>=5.1.1
+Requires-Dist: sqlalchemy[asyncio]>=2.0.0
+Requires-Dist: structlog>=25.5.0
+Requires-Dist: typer>=0.21.1
+Provides-Extra: fastapi
+Requires-Dist: neva-fastapi>=1.0.0; extra == 'fastapi'
+Provides-Extra: testing
+Requires-Dist: pytest-asyncio>=0.25.3; extra == 'testing'
+Requires-Dist: pytest>=9.0.2; extra == 'testing'
+Description-Content-Type: text/markdown
+
+# python-neva
+
+The core of the **Neva** framework — a Laravel-inspired toolkit for Python that
+brings Laravel's philosophy, terminology, and conventions to the Python
+ecosystem: service providers, facades, `bind`/`make` dependency injection (on
+[dishka](https://github.com/reagento/dishka)), `Hash`/`Crypt`/`Config`/`Log`/`Event`
+facades, a transaction-aware event system, and Result/Option error handling.
+
+`python-neva` is the **framework-agnostic core**. Web- and protocol-specific
+concerns live in separate integration packages (the plugins below) so the core
+never depends on a particular HTTP or messaging framework.
+
+## Plugins & ecosystem
+
+Neva is split into one repository per package. The core is published as
+[`python-neva`](https://pypi.org/project/python-neva/); each plugin is an
+independent repo, independently versioned and published.
+
+| Package           | Repo / directory   | Role                                                                                  | Status                          |
+| ----------------- | ------------------ | ------------------------------------------------------------------------------------- | ------------------------------- |
+| `python-neva`     | `neva/`            | **Core, framework-agnostic.** DI, service providers, facades, Result/Option, events, security, observability, SQLAlchemy database layer. | published ([PyPI](https://pypi.org/project/python-neva/)) |
+| `neva-fastapi`    | `neva-fastapi/`    | FastAPI integration — `App` extends `FastAPI` and wires dishka into routes. Pulled in via the `python-neva[fastapi]` extra. | published ([PyPI](https://pypi.org/project/neva-fastapi/)) |
+| `neva-faststream` | `neva-faststream/` | FastStream (messaging) integration.                                                   | scaffolded, early placeholder   |
+| `neva-auth`       | `neva-auth/`       | Authentication & identity toolkit — token-issuance engine, OAuth2 grants, guards, pluggable formats/backends. | core complete, OAuth-server slice in progress |
+| `neva-example`    | `neva-example/`    | Reference application consuming `python-neva[fastapi]`. Not published; demonstration + integration test bed. | unpublished                     |
+
+> When working across packages locally, each repo can be cloned as a sibling
+> directory; integration packages depend on `python-neva` from PyPI (or an
+> editable local path during development).
+
+## Develop
+
+```bash
+uv sync          # install/refresh deps from uv.lock
+poe lint         # ruff check
+poe fmt          # ruff format
+poe tc           # type-check (mypy)
+poe test         # pytest
+poe test-cov     # tests with coverage
+
+# Run a single test
+pytest tests/test_file.py::TestClass::test_method -v
+```
+
+`asyncio_mode = "auto"` is set, so async tests need no `@pytest.mark.asyncio`.
+
+## Contributing
+
+**Commits** follow [Conventional Commits](https://www.conventionalcommits.org/)
+with [gitmoji](https://gitmoji.dev/) prefixes, enforced by
+[`cz_gitmoji`](https://github.com/ljnsn/cz-conventional-gitmoji). Commitizen is
+provided as a dev dependency — no separate install needed. Run the guided
+wizard:
+
+```bash
+cz commit
+```
+
+or format manually as `:gitmoji: type(scope): subject`.
+
+**Releases** are cut per-repo with commitizen, from the repo root:
+
+```bash
+cz bump                              # bump version in pyproject, write CHANGELOG, tag v<version>
+git push --follow-tags origin main
+uv build && uv publish               # build + publish the wheel/sdist
+```
+
+`cz bump` derives the bump level (major/minor/patch) from the commits since the
+last tag, updates `CHANGELOG.md`, and runs `scripts/retag-with-changelog.sh` to
+rewrite the new tag with the rendered changelog as its annotation.
+
+## Feature ideas
+
+- Feature-parity FastStream integration (now scaffolded as `neva-faststream`)
+- Finish cleaning up the core package (moving any remaining ASGI-dependent code into the appropriate integration packages)
+- Improved router registration (auto-discovery OR provider-based? both?)
+- Improved security tooling (performance improvements, better defaults, etc.)
+- Better OpenTelemetry integration
+- Improved factory module (based on Polyfactory)
+- Queue/Jobs system
+- CLI integration

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

@@ -15,13 +15,13 @@ neva/config/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 neva/config/repository.py,sha256=-6lG0LcAO30OoJ9vSS4U1xO2o8-EWhSib5_CVEiZkyk,4750
 neva/database/__init__.py,sha256=3yYnEe8HQM86tURyAhTbMtE7AXubIEMN3GuwxkkT-bk,508
 neva/database/config.py,sha256=bVKUqlrYDFrURqg_FbntPXyVkbOUPSVXQJTKjyucjL0,451
-neva/database/connection.py,sha256=7bETJ9wXb6_lwbazG25XDTuGKKKaEmetBTSI9JdM94Q,6308
+neva/database/connection.py,sha256=zRN0AJHj2BTXC92EnE6UKSMOhlCbikCAT0W7yue11Qg,6211
 neva/database/manager.py,sha256=VNvhVumZD2hoGKpkdXMAkT6KykE4H80WcG2DgShK5Hs,4240
 neva/database/provider.py,sha256=l2be4Ri53RtQq1-qzohy3cqzJQpTaNzqXGVhXPKUCXc,1674
 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=5M8s3aVzx9lIViGkigtu1kq6gFbam4OKDajuWNGuqA0,4376
+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
@@ -73,15 +73,15 @@ 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=AL_v8fxkvtd9KwbiWbVuUAcdZz0yzLn8xZROFa6lXLE,546
+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
@@ -91,6 +91,6 @@ 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.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,,
+python_neva-3.5.1.dist-info/METADATA,sha256=g3oinewGocjJnVZ2LztQQMtNLOCEJcsOwjDw-F6_o50,5026
+python_neva-3.5.1.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+python_neva-3.5.1.dist-info/RECORD,,

{python_neva-3.4.0.dist-info → python_neva-3.5.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.32.0
 Root-Is-Purelib: true
 Tag: py3-none-any

python_neva-3.4.0.dist-info/METADATA

@@ -1,27 +0,0 @@
-Metadata-Version: 2.4
-Name: python-neva
-Version: 3.4.0
-Summary: Add your description here
-Requires-Python: >=3.12
-Requires-Dist: aiosqlite>=0.20.0
-Requires-Dist: asyncpg>=0.30.0
-Requires-Dist: cryptography>=46.0.3
-Requires-Dist: dishka>=1.10.0
-Requires-Dist: fastapi[all]>=0.129.0
-Requires-Dist: faststream>=0.6.6
-Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.62b0
-Requires-Dist: pwdlib[argon2,bcrypt]>=0.3.0
-Requires-Dist: pyinstrument>=5.1.1
-Requires-Dist: sqlalchemy[asyncio]>=2.0.0
-Requires-Dist: structlog>=25.5.0
-Requires-Dist: typer>=0.21.1
-Provides-Extra: fastapi
-Requires-Dist: neva-fastapi>=1.0.0; extra == 'fastapi'
-Provides-Extra: testing
-Requires-Dist: pytest-asyncio>=0.25.3; extra == 'testing'
-Requires-Dist: pytest>=9.0.2; extra == 'testing'
-Description-Content-Type: text/markdown
-
-# The Neva framework
-
-PLACEHOLDER