sqlalchemy-foundation-kit 0.0.0__tar.gz → 0.2.0__tar.gz

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.2.0](https://github.com/bedrock-python/sqlalchemy-foundation-kit/compare/sqlalchemy-foundation-kit-v0.1.0...sqlalchemy-foundation-kit-v0.2.0) (2026-08-28)
+
+
+### Features
+
+* **uow:** add savepoint() to AsyncSQLAlchemyUowTransaction ([#6](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/6)) ([c46d881](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/c46d881052b7476211c31f4adc6058d4f5500b6a)), closes [#5](https://github.com/bedrock-python/sqlalchemy-foundation-kit/issues/5)
+
+
+### Bug Fixes
+
+* **ci:** add workflow_dispatch and created trigger to publish workflow ([142aef5](https://github.com/bedrock-python/sqlalchemy-foundation-kit/commit/142aef5040777b31509e8d7b26f01774e8f22432))
+
 ## 0.1.0 (2026-05-19)
 
 

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: sqlalchemy-foundation-kit
-Version: 0.0.0
+Version: 0.2.0
 Summary: Foundation layer for SQLAlchemy-based services with UoW, session management, and observability
 Project-URL: Repository, https://github.com/bedrock-python/sqlalchemy-foundation-kit
 Project-URL: Documentation, https://bedrock-python.github.io/sqlalchemy-foundation-kit/
@@ -462,7 +462,7 @@ class CreateUserUseCase:
 ### Core (always available)
 - **Session Management**: `AsyncSessionManager`, `AsyncCConnection`
 - **Base ORM**: `Base`, `BaseTable`, `DatetimeColumnsMixin`, `UnConstrainedEnum`, `PydanticJSONB`
-- **Unit of Work**: `AsyncUnitOfWork`, `AsyncSQLAlchemyUnitOfWork`, `IsolationLevel`
+- **Unit of Work**: `AsyncUnitOfWork`, `AsyncSQLAlchemyUnitOfWork`, `IsolationLevel`, `SupportsSavepoint`
 - **Protocols**: `PostgresSettingsProtocol`, `PostgresMetricsProtocol`
 - **Utilities**: `build_engine_kwargs`, `resolve_pool_class`, `load_orm_metadata`
 

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/README.md

@@ -212,7 +212,7 @@ class CreateUserUseCase:
 ### Core (always available)
 - **Session Management**: `AsyncSessionManager`, `AsyncCConnection`
 - **Base ORM**: `Base`, `BaseTable`, `DatetimeColumnsMixin`, `UnConstrainedEnum`, `PydanticJSONB`
-- **Unit of Work**: `AsyncUnitOfWork`, `AsyncSQLAlchemyUnitOfWork`, `IsolationLevel`
+- **Unit of Work**: `AsyncUnitOfWork`, `AsyncSQLAlchemyUnitOfWork`, `IsolationLevel`, `SupportsSavepoint`
 - **Protocols**: `PostgresSettingsProtocol`, `PostgresMetricsProtocol`
 - **Utilities**: `build_engine_kwargs`, `resolve_pool_class`, `load_orm_metadata`
 

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/sqlalchemy_foundation_kit/__init__.py

@@ -58,12 +58,13 @@ from .uow import (
     IsolationLevel,
     PostgresAdvisoryLockMixin,
     SupportsAdvisoryLock,
+    SupportsSavepoint,
 )
 
 try:
     __version__ = version("sqlalchemy-foundation-kit")
 except PackageNotFoundError:  # pragma: no cover
-    __version__ = "0.1.0"
+    __version__ = "0.2.0"
 
 __all__ = [  # noqa: RUF022
     # Base ORM
@@ -109,6 +110,7 @@ __all__ = [  # noqa: RUF022
     "IsolationLevel",
     "PostgresAdvisoryLockMixin",
     "SupportsAdvisoryLock",
+    "SupportsSavepoint",
     # Version
     "__version__",
 ]

sqlalchemy_foundation_kit-0.2.0/sqlalchemy_foundation_kit/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"  # x-release-please-version

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/sqlalchemy_foundation_kit/uow/__init__.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from .enums import IsolationLevel
-from .protocols import AsyncUnitOfWork, AsyncUowTransaction, SupportsAdvisoryLock
+from .protocols import AsyncUnitOfWork, AsyncUowTransaction, SupportsAdvisoryLock, SupportsSavepoint
 from .sqlalchemy import (
     AsyncSQLAlchemyUnitOfWork,
     AsyncSQLAlchemyUowTransaction,
@@ -18,4 +18,5 @@ __all__ = [
     "IsolationLevel",
     "PostgresAdvisoryLockMixin",
     "SupportsAdvisoryLock",
+    "SupportsSavepoint",
 ]

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/sqlalchemy_foundation_kit/uow/protocols.py

@@ -32,6 +32,24 @@ class SupportsAdvisoryLock(Protocol):
         ...
 
 
+class SupportsSavepoint(Protocol):
+    """Capability protocol for transactions supporting savepoints.
+
+    Use this when a use case must keep going after one step fails — for example,
+    processing a batch of independent items where a bad item must not take the
+    rest of the batch (or the record of its own failure) down with it.
+    """
+
+    def savepoint(self) -> AbstractAsyncContextManager[None]:
+        """Open a nested block whose failure does not poison the surrounding transaction.
+
+        On exception the block's changes are rolled back, the exception propagates
+        unchanged, and the surrounding transaction remains usable. On success the
+        block's changes stay part of the surrounding transaction.
+        """
+        ...
+
+
 class AsyncUnitOfWork(Protocol, Generic[T_co]):
     """Provides transactional context for repository operations.
 

{sqlalchemy_foundation_kit-0.0.0 → sqlalchemy_foundation_kit-0.2.0}/sqlalchemy_foundation_kit/uow/sqlalchemy.py

@@ -129,6 +129,37 @@ class AsyncSQLAlchemyUowTransaction(AsyncUowTransaction):
         """Get the underlying SQLAlchemy async session."""
         return self._session
 
+    @asynccontextmanager
+    async def savepoint(self) -> AsyncIterator[None]:
+        """Open a savepoint whose failure does not poison the surrounding transaction.
+
+        On PostgreSQL a single failed statement aborts the whole transaction: every
+        later statement on the connection fails until rollback, including the ones
+        that would record which step failed. A savepoint (``SAVEPOINT`` /
+        ``ROLLBACK TO SAVEPOINT``) narrows that blast radius to this block.
+
+        On exception the block's changes are rolled back, the exception propagates
+        unchanged — the caller decides what a failed step means — and the surrounding
+        transaction stays usable. On success the savepoint is released and its changes
+        remain part of the surrounding transaction, committed or rolled back with it.
+        Savepoints nest: a ``savepoint()`` inside another rolls back only the inner block.
+
+        Intended for use inside :meth:`AsyncSQLAlchemyUnitOfWork.transaction` or
+        :meth:`AsyncSQLAlchemyUnitOfWork.managed_session`.
+
+        Example:
+            async with uow.transaction() as tx:
+                for event in await tx.outbox.list_pending():
+                    try:
+                        async with tx.savepoint():
+                            await tx.outbox.process(event)
+                    except Exception as exc:
+                        await tx.outbox.mark_failed(event, reason=str(exc))
+                # Commits processed events and failure records together
+        """
+        async with self._session.begin_nested():
+            yield
+
 
 class PostgresAdvisoryLockMixin:
     """Mixin providing PostgreSQL advisory lock support for UoW transactions.

sqlalchemy_foundation_kit-0.0.0/sqlalchemy_foundation_kit/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.0.0"