sqlphilosophy 0.1.9__tar.gz → 0.2.0__tar.gz

{sqlphilosophy-0.1.9/src/sqlphilosophy.egg-info → sqlphilosophy-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlphilosophy
-Version: 0.1.9
+Version: 0.2.0
 Summary: Portable SQLAlchemy repository kit: sync and async CRUD, statement builders, sort/pagination, and SQL helpers.
 Author-email: Josh Martin <denverprogrammer@gmail.com>
 License-Expression: MIT
@@ -20,6 +20,7 @@ Classifier: Typing :: Typed
 Requires-Python: <4.0,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: servicephilosophy>=0.1.0
 Requires-Dist: sqlalchemy<3,>=2.0
 Provides-Extra: async
 Requires-Dist: greenlet>=3.0; extra == "async"
@@ -56,6 +57,7 @@ Portable SQLAlchemy repository kit: sync and async CRUD, fluent statement builde
 | [Repository guide](./docs/repository-guide.md) | Entry point: overview, transaction model, links to usage pages |
 | [Usage examples](./docs/usage/) | Focused sync/async code examples by feature area |
 | [Strongly typed repositories](./docs/usage/strongly-typed-repositories.md) | Typed subclasses, factories, protocols, and service patterns |
+| [Service factory composition](./docs/usage/service-factory-composition.md) | Compose sqlPhilosophy SQL repos with servicePhilosophy business services |
 | [Before/after SQLAlchemy](./docs/usage/before-after-sqlalchemy.md) | Migration examples: direct SQLAlchemy vs repository-centered code |
 | [Feature matrix](./docs/feature-matrix.md) | Full sync/async capability map |
 | [Typed repository (sync)](./docs/examples/typed_repository_sync.py) | Runnable factory + domain repo example |

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/README.md

@@ -17,6 +17,7 @@ Portable SQLAlchemy repository kit: sync and async CRUD, fluent statement builde
 | [Repository guide](./docs/repository-guide.md) | Entry point: overview, transaction model, links to usage pages |
 | [Usage examples](./docs/usage/) | Focused sync/async code examples by feature area |
 | [Strongly typed repositories](./docs/usage/strongly-typed-repositories.md) | Typed subclasses, factories, protocols, and service patterns |
+| [Service factory composition](./docs/usage/service-factory-composition.md) | Compose sqlPhilosophy SQL repos with servicePhilosophy business services |
 | [Before/after SQLAlchemy](./docs/usage/before-after-sqlalchemy.md) | Migration examples: direct SQLAlchemy vs repository-centered code |
 | [Feature matrix](./docs/feature-matrix.md) | Full sync/async capability map |
 | [Typed repository (sync)](./docs/examples/typed_repository_sync.py) | Runnable factory + domain repo example |

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/pyproject.toml

@@ -24,6 +24,7 @@ classifiers = [
 ]
 dynamic = ["version"]
 dependencies = [
+    "servicephilosophy>=0.1.0",
     "sqlalchemy>=2.0,<3",
 ]
 

sqlphilosophy-0.2.0/src/sqlphilosophy/VERSION

@@ -0,0 +1 @@
+0.2.0

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/src/sqlphilosophy/aio/protocols.py

@@ -8,6 +8,7 @@ from typing import TYPE_CHECKING, Any, Protocol, TypeVar
 if TYPE_CHECKING:
     from sqlphilosophy.aio.repository import AsyncBaseRepository
 
+from servicephilosophy import RepositoryFactoryProtocol, ServiceRepositoryProtocol
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import DeclarativeBase
 
@@ -18,14 +19,35 @@ T = TypeVar("T", bound=DeclarativeBase)
 R = TypeVar("R", bound="AsyncBaseRepository[Any, Any]")
 
 
-class AsyncBaseRepositoryProtocol[T: DeclarativeBase, U: AsyncRepositoryFactory | None](
+class AsyncRepositoryFactory(RepositoryFactoryProtocol, Protocol):
+    """Async session-scoped factory for statement builders and entity repositories."""
+
+    def create_statement(self, model: type[T]) -> AsyncStatementQueryBuilder[T]:
+        """Return a fluent async read builder for ``model``."""
+        ...
+
+    def get_repository(self, repo_class: type[R]) -> R:
+        """Return a cached typed entity repository."""
+        ...
+
+    def repository(self, model: type[T]) -> AsyncBaseRepositoryProtocol[T, AsyncRepositoryFactory]:
+        """Return generic CRUD helpers for ``model`` (``AsyncBaseRepository``)."""
+        ...
+
+
+class AsyncBaseRepositoryProtocol[T: DeclarativeBase, U: AsyncRepositoryFactory](
+    ServiceRepositoryProtocol[U],
     Protocol,
 ):
-    """Generic read/write surface shared by sqlphilosophy ``AsyncBaseRepository[T]``."""
+    """Async SQL read/write surface for ``AsyncBaseRepository[T]``.
+
+    Factory access (``.factory``, ``.maybe_factory``, ``.has_factory``) is inherited
+    from ``ServiceRepositoryProtocol``; this protocol adds the mapped model, session,
+    and SQLAlchemy CRUD/query methods only.
+    """
 
     model: type[T]
     _session: AsyncSession
-    _factory: U | None
 
     async def get(self, obj_id: PrimaryKey, load_relations: Any = None) -> T: ...
 
@@ -88,19 +110,3 @@ class AsyncBaseRepositoryProtocol[T: DeclarativeBase, U: AsyncRepositoryFactory
         values: RowMapping,
         params: RowMapping | None = None,
     ) -> int: ...
-
-
-class AsyncRepositoryFactory(Protocol):
-    """Session-scoped factory for async statement builders and entity repositories."""
-
-    def create_statement(self, model: type[T]) -> AsyncStatementQueryBuilder[T]:
-        """Return a fluent async read builder for ``model``."""
-        ...
-
-    def get_repository(self, repo_class: type[R]) -> R:
-        """Return a cached typed entity repository."""
-        ...
-
-    def repository(self, model: type[T]) -> AsyncBaseRepositoryProtocol[T, AsyncRepositoryFactory | None]:
-        """Return generic CRUD helpers for ``model`` (``AsyncBaseRepository`` in Phobos)."""
-        ...

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/src/sqlphilosophy/aio/repository.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from collections.abc import Sequence
 from typing import Any, cast
 
+from servicephilosophy import ServiceRepository
 from sqlalchemy import delete, func, select, update
 from sqlalchemy import inspect as sa_inspect
 from sqlalchemy.ext.asyncio import AsyncSession
@@ -40,18 +41,18 @@ from sqlphilosophy.types import (
 LoadRelations = Sequence[LoaderOption]
 
 
-class AsyncBaseRepository[T: DeclarativeBase, U: AsyncRepositoryFactory | None]:
+class AsyncBaseRepository[T: DeclarativeBase, U: AsyncRepositoryFactory](ServiceRepository[U]):
     """Async session-scoped CRUD helpers for a single mapped model."""
 
     def __init__(
         self,
         model: type[T],
         session: AsyncSession,
-        factory: AsyncRepositoryFactory | None = None,
+        factory: U | None = None,
     ) -> None:
+        super().__init__(factory)
         self.model = model
         self._session = session
-        self._factory = factory
         self._pk_column = require_single_column_primary_key(model, self.inspect_model(model))
 
     @classmethod
@@ -375,12 +376,14 @@ class AsyncBaseRepository[T: DeclarativeBase, U: AsyncRepositoryFactory | None]:
 
     def statement(self) -> AsyncStatementQueryBuilder[T]:
         """Return a fluent statement builder for reads on this model (default read path)."""
-        if self._factory is not None:
-            return self._factory.create_statement(self.model)
+        factory = self.maybe_factory
+        if factory is not None:
+            return factory.create_statement(self.model)
         return AsyncSqlAlchemyStatementBuilder(self._session, self.model)
 
     def for_repo[R: AsyncBaseRepository[Any, Any]](self, repo_class: type[R]) -> R:
-        """Return a typed entity repository sharing this session and factory."""
-        if self._factory is None:
-            raise RuntimeError("for_repo() requires an AsyncRepositoryFactory")
-        return cast(R, self._factory.get_repository(repo_class))
+        """Return a typed entity repository sharing this session and factory.
+
+        Raises ``FactoryRequiredError`` when no factory was configured.
+        """
+        return cast(R, self.factory.get_repository(repo_class))

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/src/sqlphilosophy/sync/protocols.py

@@ -8,6 +8,7 @@ from typing import TYPE_CHECKING, Any, Protocol, TypeVar
 if TYPE_CHECKING:
     from sqlphilosophy.sync.repository import BaseRepository
 
+from servicephilosophy import RepositoryFactoryProtocol, ServiceRepositoryProtocol
 from sqlalchemy.orm import DeclarativeBase, Session
 
 from sqlphilosophy.sync.query import StatementQueryBuilder
@@ -17,12 +18,35 @@ T = TypeVar("T", bound=DeclarativeBase)
 R = TypeVar("R", bound="BaseRepository[Any, Any]")
 
 
-class BaseRepositoryProtocol[T: DeclarativeBase, U: RepositoryFactory | None](Protocol):
-    """Generic read/write surface shared by sqlphilosophy ``BaseRepository[T]``."""
+class RepositoryFactory(RepositoryFactoryProtocol, Protocol):
+    """Sync session-scoped factory for statement builders and entity repositories."""
+
+    def create_statement(self, model: type[T]) -> StatementQueryBuilder[T]:
+        """Return a fluent read builder for ``model``."""
+        ...
+
+    def get_repository(self, repo_class: type[R]) -> R:
+        """Return a cached typed entity repository."""
+        ...
+
+    def repository(self, model: type[T]) -> BaseRepositoryProtocol[T, RepositoryFactory]:
+        """Return generic CRUD helpers for ``model`` (``BaseRepository``)."""
+        ...
+
+
+class BaseRepositoryProtocol[T: DeclarativeBase, U: RepositoryFactory](
+    ServiceRepositoryProtocol[U],
+    Protocol,
+):
+    """SQL read/write surface for ``BaseRepository[T]``.
+
+    Factory access (``.factory``, ``.maybe_factory``, ``.has_factory``) is inherited
+    from ``ServiceRepositoryProtocol``; this protocol adds the mapped model, session,
+    and SQLAlchemy CRUD/query methods only.
+    """
 
     model: type[T]
     _session: Session
-    _factory: U | None
 
     def get(self, obj_id: PrimaryKey, load_relations: Any = None) -> T: ...
 
@@ -85,19 +109,3 @@ class BaseRepositoryProtocol[T: DeclarativeBase, U: RepositoryFactory | None](Pr
         values: RowMapping,
         params: RowMapping | None = None,
     ) -> int: ...
-
-
-class RepositoryFactory(Protocol):
-    """Session-scoped factory for statement builders and entity repositories."""
-
-    def create_statement(self, model: type[T]) -> StatementQueryBuilder[T]:
-        """Return a fluent read builder for ``model``."""
-        ...
-
-    def get_repository(self, repo_class: type[R]) -> R:
-        """Return a cached typed entity repository."""
-        ...
-
-    def repository(self, model: type[T]) -> BaseRepositoryProtocol[T, RepositoryFactory | None]:
-        """Return generic CRUD helpers for ``model`` (``BaseRepository`` in Phobos)."""
-        ...

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/src/sqlphilosophy/sync/repository.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from collections.abc import Sequence
 from typing import Any, cast
 
+from servicephilosophy import ServiceRepository
 from sqlalchemy import delete, func, select, update
 from sqlalchemy import inspect as sa_inspect
 from sqlalchemy.orm import DeclarativeBase, Session
@@ -37,18 +38,18 @@ from sqlphilosophy.types import (
 LoadRelations = Sequence[LoaderOption]
 
 
-class BaseRepository[T: DeclarativeBase, U: RepositoryFactory | None]:
-    """Session-scoped CRUD helpers for a single mapped model."""
+class BaseRepository[T: DeclarativeBase, U: RepositoryFactory](ServiceRepository[U]):
+    """Sync session-scoped CRUD helpers for a single mapped model."""
 
     def __init__(
         self,
         model: type[T],
         session: Session,
-        factory: RepositoryFactory | None = None,
+        factory: U | None = None,
     ) -> None:
+        super().__init__(factory)
         self.model = model
         self._session = session
-        self._factory = factory
         self._pk_column = require_single_column_primary_key(model, self.inspect_model(model))
 
     @classmethod
@@ -335,12 +336,14 @@ class BaseRepository[T: DeclarativeBase, U: RepositoryFactory | None]:
 
     def statement(self) -> StatementQueryBuilder[T]:
         """Return a fluent statement builder for reads on this model (default read path)."""
-        if self._factory is not None:
-            return self._factory.create_statement(self.model)
+        factory = self.maybe_factory
+        if factory is not None:
+            return factory.create_statement(self.model)
         return SqlAlchemyStatementBuilder(self._session, self.model)
 
     def for_repo[R: BaseRepository[Any, Any]](self, repo_class: type[R]) -> R:
-        """Return a typed entity repository sharing this session and factory."""
-        if self._factory is None:
-            raise RuntimeError("for_repo() requires a RepositoryFactory")
-        return cast(R, self._factory.get_repository(repo_class))
+        """Return a typed entity repository sharing this session and factory.
+
+        Raises ``FactoryRequiredError`` when no factory was configured.
+        """
+        return cast(R, self.factory.get_repository(repo_class))

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0/src/sqlphilosophy.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlphilosophy
-Version: 0.1.9
+Version: 0.2.0
 Summary: Portable SQLAlchemy repository kit: sync and async CRUD, statement builders, sort/pagination, and SQL helpers.
 Author-email: Josh Martin <denverprogrammer@gmail.com>
 License-Expression: MIT
@@ -20,6 +20,7 @@ Classifier: Typing :: Typed
 Requires-Python: <4.0,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: servicephilosophy>=0.1.0
 Requires-Dist: sqlalchemy<3,>=2.0
 Provides-Extra: async
 Requires-Dist: greenlet>=3.0; extra == "async"
@@ -56,6 +57,7 @@ Portable SQLAlchemy repository kit: sync and async CRUD, fluent statement builde
 | [Repository guide](./docs/repository-guide.md) | Entry point: overview, transaction model, links to usage pages |
 | [Usage examples](./docs/usage/) | Focused sync/async code examples by feature area |
 | [Strongly typed repositories](./docs/usage/strongly-typed-repositories.md) | Typed subclasses, factories, protocols, and service patterns |
+| [Service factory composition](./docs/usage/service-factory-composition.md) | Compose sqlPhilosophy SQL repos with servicePhilosophy business services |
 | [Before/after SQLAlchemy](./docs/usage/before-after-sqlalchemy.md) | Migration examples: direct SQLAlchemy vs repository-centered code |
 | [Feature matrix](./docs/feature-matrix.md) | Full sync/async capability map |
 | [Typed repository (sync)](./docs/examples/typed_repository_sync.py) | Runnable factory + domain repo example |

{sqlphilosophy-0.1.9 → sqlphilosophy-0.2.0}/src/sqlphilosophy.egg-info/requires.txt

@@ -1,3 +1,4 @@
+servicephilosophy>=0.1.0
 sqlalchemy<3,>=2.0
 
 [async]

sqlphilosophy-0.1.9/src/sqlphilosophy/VERSION

@@ -1 +0,0 @@
-0.1.9