python-hexagonal 0.1.0__py3-none-any.whl

hexagonal/ports/drivens/application.py

@@ -0,0 +1,35 @@
+from abc import ABC, abstractmethod
+from typing import Generic, Iterable
+
+from hexagonal.domain import (
+    CloudMessage,
+    QueryResults,
+    TEvento,
+    TMessagePayloadType,
+    TQuery,
+    TView,
+)
+
+from .repository import ISearchRepository, TManager
+
+
+class IUseCase(ABC):
+    @abstractmethod
+    def execute(self) -> Iterable[TEvento]: ...
+
+
+class IMessageHandler(ABC, Generic[TMessagePayloadType]):
+    @abstractmethod
+    def handle_message(self, message: CloudMessage[TMessagePayloadType]) -> None: ...
+
+    @abstractmethod
+    def get_use_case(self, message: TMessagePayloadType) -> IUseCase: ...
+
+
+class IQueryHandler(ABC, Generic[TManager, TQuery, TView]):
+    @property
+    @abstractmethod
+    def repository(self) -> ISearchRepository[TManager, TQuery, TView]: ...
+
+    @abstractmethod
+    def get(self, query: TQuery) -> QueryResults[TView]: ...

hexagonal/ports/drivens/buses.py

@@ -0,0 +1,148 @@
+from abc import ABC, abstractmethod
+from typing import Callable, Generic, Literal, Type, overload
+
+from hexagonal.domain import (
+    CloudMessage,
+    Query,
+    QueryResult,
+    QueryResults,
+    TCommand,
+    TEvent,
+    TQuery,
+    TView,
+)
+
+from .application import IMessageHandler, IQueryHandler
+from .infrastructure import IBaseInfrastructure
+from .repository import IInboxRepository, IOutboxRepository, TManager
+
+
+class IBaseMessageBus(IBaseInfrastructure, ABC, Generic[TManager]):
+    @property
+    @abstractmethod
+    def inbox_repository(self) -> IInboxRepository[TManager]: ...
+
+    @property
+    @abstractmethod
+    def outbox_repository(self) -> IOutboxRepository[TManager]: ...
+
+    @abstractmethod
+    def publish_from_outbox(self, limit: int | None = None):
+        """Publicar mensajes desde la outbox., hasta el límite especificado."""
+        ...
+
+    @abstractmethod
+    def consume(self, limit: int | None = None):
+        """Consumir mensajes desde la inbox, hasta el límite especificado."""
+        ...
+
+
+class ICommandBus(IBaseMessageBus[TManager], ABC):
+    @abstractmethod
+    def register_handler(
+        self, command_type: Type[TCommand], handler: IMessageHandler[TCommand]
+    ) -> None:
+        """Registrar un manejador para un tipo de comando."""
+        ...
+
+    @abstractmethod
+    def unregister_handler(self, command_type: Type[TCommand]) -> None:
+        """Desregistrar el manejador para un tipo de comando."""
+        ...
+
+    @abstractmethod
+    def dispatch(
+        self,
+        command: TCommand | CloudMessage[TCommand],
+        *,
+        to_outbox: bool = False,
+    ) -> None:
+        """Despachar un comando para su procesamiento."""
+        ...
+
+    @abstractmethod
+    def process_command(self, command: CloudMessage[TCommand]) -> None:
+        """Procesar un comando recibido."""
+        ...
+
+
+class IEventBus(IBaseMessageBus[TManager], ABC):
+    @abstractmethod
+    def subscribe(self, event_type: Type[TEvent], handler: IMessageHandler[TEvent]):
+        """Suscribir un manejador a un tipo de evento."""
+        ...
+
+    @abstractmethod
+    def unsubscribe(
+        self,
+        event_type: Type[TEvent],
+        *handlers: IMessageHandler[TEvent],
+    ): ...
+
+    @abstractmethod
+    def publish(self, *events: CloudMessage[TEvent]) -> None:
+        """Publicar un evento a todos sus suscriptores."""
+        ...
+
+    @abstractmethod
+    def process_events(self, *events: CloudMessage[TEvent]) -> None: ...
+
+    #  wait for
+    @overload
+    def wait_for_publish(
+        self, event_type: Type[TEvent], handler: Callable[[TEvent], None]
+    ) -> None: ...
+    @overload
+    def wait_for_publish(
+        self, event_type: Type[TEvent]
+    ) -> Callable[[Callable[[TEvent], None]], None]: ...
+
+    @abstractmethod
+    def wait_for_publish(
+        self, event_type: Type[TEvent], handler: Callable[[TEvent], None] | None = None
+    ) -> Callable[[Callable[[TEvent], None]], None] | None: ...
+
+
+class IQueryBus(IBaseInfrastructure, Generic[TManager]):
+    @abstractmethod
+    def register_handler(
+        self,
+        query_type: Type[TQuery],
+        handler: IQueryHandler[TManager, TQuery, TView],
+    ): ...
+
+    @abstractmethod
+    def unregister_handler(self, query_type: Type[Query[TView]]): ...
+
+    @overload
+    def get(self, query: Query[TView], *, one: Literal[True]) -> QueryResult[TView]: ...
+
+    @overload
+    def get(
+        self,
+        query: Query[TView],
+        *,
+        one: Literal[False] = False,
+    ) -> QueryResults[TView]: ...
+
+    @abstractmethod
+    def get(
+        self,
+        query: Query[TView],
+        *,
+        one: bool = False,
+    ) -> QueryResult[TView] | QueryResults[TView]: ...
+
+
+class IBusInfrastructure(IBaseInfrastructure, Generic[TManager]):
+    @property
+    @abstractmethod
+    def command_bus(self) -> ICommandBus[TManager]: ...
+
+    @property
+    @abstractmethod
+    def event_bus(self) -> IEventBus[TManager]: ...
+
+    @property
+    @abstractmethod
+    def query_bus(self) -> IQueryBus[TManager]: ...

hexagonal/ports/drivens/infrastructure.py

@@ -0,0 +1,19 @@
+from abc import ABC, abstractmethod
+from typing import Mapping
+
+from hexagonal.domain import InfrastructureNotInitialized
+
+
+class IBaseInfrastructure(ABC):
+    @property
+    @abstractmethod
+    def initialized(self) -> bool: ...
+
+    @abstractmethod
+    def initialize(self, env: Mapping[str, str]) -> None: ...
+
+    def verify(self):
+        if not self.initialized:
+            raise InfrastructureNotInitialized(
+                f"{self.__class__.__name__} is not initialized"
+            )

hexagonal/ports/drivens/repository.py

@@ -0,0 +1,152 @@
+from abc import ABC, abstractmethod
+from contextlib import contextmanager
+from typing import Any, Generic, List, Self, TypeVar
+from uuid import UUID
+
+from hexagonal.domain import (
+    AggregateRoot,
+    CloudMessage,
+    TIdEntity,
+    TQuery,
+    TView,
+)
+
+from .infrastructure import IBaseInfrastructure
+
+TAggregate = TypeVar("TAggregate", bound=AggregateRoot[Any, Any])
+
+
+class IConnectionManager(IBaseInfrastructure, ABC):
+    @contextmanager
+    @abstractmethod
+    def start_connection(self) -> Any: ...
+
+
+TManager = TypeVar("TManager", bound=IConnectionManager)
+
+
+class IBaseRepository(IBaseInfrastructure, Generic[TManager]):
+    @property
+    @abstractmethod
+    def connection_manager(self) -> TManager: ...
+
+    @abstractmethod
+    def attach_to_unit_of_work(self, uow: "IUnitOfWork[TManager]") -> None: ...
+
+    @abstractmethod
+    def detach_from_unit_of_work(self) -> None: ...
+
+
+class IUnitOfWork(IBaseInfrastructure, ABC, Generic[TManager]):
+    @property
+    @abstractmethod
+    def connection_manager(self) -> TManager: ...
+
+    @abstractmethod
+    def commit(self) -> None: ...
+
+    @abstractmethod
+    def rollback(self) -> None: ...
+
+    @abstractmethod
+    def attach_repo(self, repo: IBaseRepository[TManager]) -> None: ...
+
+    @abstractmethod
+    def detach_repo(self, repo: IBaseRepository[TManager]) -> None: ...
+
+    def __enter__(self) -> Self:
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):  # type: ignore
+        if exc_type is None:
+            self.commit()
+        else:
+            self.rollback()
+
+
+class IAggregateRepository(
+    IBaseRepository[TManager],
+    Generic[TManager, TAggregate, TIdEntity],
+):
+    @abstractmethod
+    def save(self, aggregate: TAggregate) -> None:
+        """Persistir el agregado en el almacenamiento."""
+        ...
+
+    @abstractmethod
+    def get(self, id: TIdEntity) -> TAggregate:
+        """Recuperar el agregado por su ID."""
+        ...
+
+    @abstractmethod
+    def delete(self, id: TIdEntity) -> TAggregate:
+        """Eliminar el agregado por su ID."""
+        ...
+
+
+class IOutboxRepository(IBaseRepository[TManager]):
+    """Puerto para manejar eventos pendientes de publicar (write-side)."""
+
+    @abstractmethod
+    def save(self, *message: CloudMessage[Any]) -> None:
+        """Guardar evento en la tabla Outbox en la misma transacción del agregado."""
+        ...
+
+    @abstractmethod
+    def fetch_pending(self, limit: int | None = None) -> list[CloudMessage[Any]]:
+        """Recuperar eventos no publicados aún."""
+        ...
+
+    @abstractmethod
+    def mark_as_published(self, *message_ids: UUID) -> None:
+        """Marcar un evento como publicado correctamente."""
+        ...
+
+    @abstractmethod
+    def mark_as_failed(self, *message_ids: UUID, error: str) -> None:
+        """Incrementar intentos o marcar el evento como fallido."""
+        ...
+
+
+class IInboxRepository(IBaseRepository[TManager]):
+    """Puerto para procesar mensajes de entrada de forma idempotente."""
+
+    @abstractmethod
+    def register_message(
+        self,
+        message: CloudMessage[Any],
+        handler: str,
+        max_retries: int = 3,
+    ) -> bool:
+        """
+        Intenta registrar un mensaje.
+        Retorna False si ya existe (duplicado).
+        """
+        ...
+
+    @abstractmethod
+    def mark_as_processed(self, message_id: UUID, handler: str) -> None:
+        """Marcar el mensaje como procesado exitosamente."""
+        ...
+
+    @abstractmethod
+    def mark_as_failed(self, message_id: UUID, handler: str, error: str) -> None:
+        """Marcar el mensaje como fallido."""
+        ...
+
+
+class ISearchRepository(IBaseRepository[TManager], Generic[TManager, TQuery, TView]):
+    @abstractmethod
+    def search(self, query: TQuery) -> List[TView]:
+        """Buscar objetos de valor según el query proporcionado."""
+        ...
+
+
+class IPairInboxOutbox(IBaseInfrastructure, Generic[TManager]):
+    @property
+    @abstractmethod
+    def inbox(self) -> IInboxRepository[TManager]: ...
+
+    @property
+    @abstractmethod
+    def outbox(self) -> IOutboxRepository[TManager]: ...

hexagonal/ports/drivers/__init__.py

@@ -0,0 +1,3 @@
+from .app import IBaseApplication, IBusApp
+
+__all__ = ["IBaseApplication", "IBusApp"]

hexagonal/ports/drivers/app.py

@@ -0,0 +1,58 @@
+from abc import ABC, abstractmethod
+from typing import Generic
+
+from hexagonal.domain import CloudMessage, TCommand, TEvent
+from hexagonal.ports.drivens import (
+    IBusInfrastructure,
+    ICommandBus,
+    IEventBus,
+    IQueryBus,
+    IUnitOfWork,
+    TManager,
+)
+
+
+class IBusApp(ABC, Generic[TManager]):
+    @property
+    @abstractmethod
+    def uow(self) -> IUnitOfWork[TManager]: ...
+
+    @abstractmethod
+    def bootstrap(
+        self,
+        command_bus: ICommandBus[TManager],
+        query_bus: IQueryBus[TManager],
+        event_bus: IEventBus[TManager],
+    ) -> None: ...
+
+
+class IBaseApplication(ABC, Generic[TManager]):
+    @property
+    @abstractmethod
+    def bus_app(self) -> IBusApp[TManager]: ...
+
+    @property
+    @abstractmethod
+    def bus_infrastructure(self) -> IBusInfrastructure[TManager]: ...
+
+    @property
+    @abstractmethod
+    def command_bus(self) -> ICommandBus[TManager]: ...
+
+    @property
+    @abstractmethod
+    def query_bus(self) -> IQueryBus[TManager]: ...
+
+    @property
+    @abstractmethod
+    def event_bus(self) -> IEventBus[TManager]: ...
+
+    @abstractmethod
+    def bootstrap(self, bus_app: IBusApp[TManager]) -> None: ...
+
+    @abstractmethod
+    def dispatch_and_wait_events(
+        self,
+        command: CloudMessage[TCommand],
+        *event_types: type[TEvent],
+    ) -> dict[type[TEvent], TEvent | None]: ...

python_hexagonal-0.1.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.3
+Name: python-hexagonal
+Version: 0.1.0
+Summary: Framework to build hexagonal architecture applications in Python.
+Author: jose-matos-9281
+Author-email: jose-matos-9281 <58991817+jose-matos-9281@users.noreply.github.com>
+Requires-Dist: eventsourcing>=9.4.6
+Requires-Dist: orjson>=3.11.5
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: uuid6>=2025.0.1
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# python-hexagonal
+Framework of Ports and adapters Architecture, applying concepts of DDD

python_hexagonal-0.1.0.dist-info/RECORD

@@ -0,0 +1,53 @@
+hexagonal/__init__.py,sha256=4GlVYmzCh2BmPst6WpxxqraLcfXmlbyrGcNFyi28dng,62
+hexagonal/adapters/drivens/buses/base/__init__.py,sha256=3RM8lIIh4425-Ixnu_v667sdM6iAwDqds3GNUAANp5M,380
+hexagonal/adapters/drivens/buses/base/command_bus.py,sha256=RhUcObspthpq4NUEooFXIV0p81FS5KsnJ3G3M0MGjFw,2226
+hexagonal/adapters/drivens/buses/base/event_bus.py,sha256=jIDuipRaO7MT7oE0M3e8ALSmqe-YnFAVgTqqbHwUXqg,5743
+hexagonal/adapters/drivens/buses/base/infrastructure.py,sha256=4x36U57kP4yk7YKGGmkQIB10JPmTFSgnaMx5OUDmeWU,965
+hexagonal/adapters/drivens/buses/base/message_bus.py,sha256=aR90tALUSqV_vVTFBG0KGRXJnbi7I4OQ-29cCkTDuUo,2591
+hexagonal/adapters/drivens/buses/base/query.py,sha256=eElI9zbfdQ7iSaSrR2sykdyKW1wBoLj86ngZzGHb40w,2424
+hexagonal/adapters/drivens/buses/base/utils.py,sha256=w1qdMpddZph2sl-S2ir_ym23Rkq9fC9MEBvJ9PB3QpU,48
+hexagonal/adapters/drivens/buses/inmemory/__init__.py,sha256=ySzpKqMKT7zc77M7AXOlGU9y8l0ZkHQ0We4wkxjuyzM,405
+hexagonal/adapters/drivens/buses/inmemory/command_bus.py,sha256=gMyk-VNSDk_gk5ihP3cUQcfNIgqmLD1Nt-yzuTB9Uy4,2271
+hexagonal/adapters/drivens/buses/inmemory/event_bus.py,sha256=xe-I4nBs2BE-vLVawRW3lXhBlW54X-XUjL9kRnX-hE0,2288
+hexagonal/adapters/drivens/buses/inmemory/infra.py,sha256=Gkjx8ZUlg5jWbSXgg64-Hgrtegbmi-mcoI0T9oEkq0U,1336
+hexagonal/adapters/drivens/mappers.py,sha256=15n1SGJ0RCGtsxPrOyNcnD2qpA-YYFCUWeA3Y1_4ric,4810
+hexagonal/adapters/drivens/repository/base/__init__.py,sha256=MZoFzptMLTIMRxjxswbj3T3vDepu4KW07fwrKRYaKDU,270
+hexagonal/adapters/drivens/repository/base/repository.py,sha256=_SC_mR65CX39boAeUnDCFAaUj1duYPtsi2CrpmpSOGM,2728
+hexagonal/adapters/drivens/repository/base/unit_of_work.py,sha256=xRn_kvbv_FYo6FDNvSDYYUuIFYeoUo7AMapyYBAzbjo,2496
+hexagonal/adapters/drivens/repository/sqlite/__init__.py,sha256=0Uzaw2atFFfjQ1ppgtKQD39YwmiEl-O9nqUI30Bww20,598
+hexagonal/adapters/drivens/repository/sqlite/datastore.py,sha256=N0r8v4slYFtIXGMBPuf1_AvqkAaayCXYQfzdDDMcrT4,7028
+hexagonal/adapters/drivens/repository/sqlite/env_vars.py,sha256=EXRbG3NlTQg3rnUUszW0IDGuQLi_Grbd2uXIX3V4mJA,88
+hexagonal/adapters/drivens/repository/sqlite/infrastructure.py,sha256=hQmogShv99cUF4PSgZlkn0BcCEMydWt0hxDREEfG5u8,736
+hexagonal/adapters/drivens/repository/sqlite/outbox.py,sha256=FdEllWC2-tMHJ3-gboHQCH7iDYtlVWeYXN6KKUC3gJc,14125
+hexagonal/adapters/drivens/repository/sqlite/repository.py,sha256=IRs9Mm_rBD-pE_D7OWlvvJgxW5WrvAHhdAz3jZgJA_k,10271
+hexagonal/adapters/drivens/repository/sqlite/unit_of_work.py,sha256=2yoP7U_WTgK6mzMtaAEcoV2hmgNNgNjT3vpxzWT8c0A,907
+hexagonal/adapters/drivers/__init__.py,sha256=tHcyqkut5K7LvlDT1QVJ3N7Z1UrmfqNYuKjlrxitoAc,87
+hexagonal/adapters/drivers/app.py,sha256=3MuDI2cl1TauoBk4qVDAOWik4dGiekUYkHPZbCCCPeE,1124
+hexagonal/application/__init__.py,sha256=IvGbZfRqI3hUA8SXn_YhSgwcyrQg9RFrgi3XtAWFV9Q,752
+hexagonal/application/api.py,sha256=YQVRAENQVtMOSPZgjWPNUaEgennPtnPN3A2XjBEdbd4,2152
+hexagonal/application/app.py,sha256=OBsJ5dPp9hdO-aKDKhdMI-PMP5UHTyadA0xAcYzq-EQ,2404
+hexagonal/application/bus_app.py,sha256=Ubwy5HKDOi1vJWT0LsEm0y1vM53ROZLbHGEw72S7eYw,1995
+hexagonal/application/handlers.py,sha256=sAirS7Fa9o5UAPamfLz0gU1ZpyEaeqCyB6qdqlweGfU,3011
+hexagonal/application/infrastructure.py,sha256=KGKnVUkFCxZvlv1mySaunzFqXX9Kvh_XP-pfueU4jc8,2047
+hexagonal/application/query.py,sha256=Td7BvPUl_rvAL2Rnf2HS8hjtH1EpfIU9BUSYvTKmGJw,2150
+hexagonal/domain/__init__.py,sha256=iVAzcLFU1A2KAeI0o-RUtp4OJdF4y4NoTmjgdtD1Bh8,1422
+hexagonal/domain/aggregate.py,sha256=byVnwM9_JuRNYp7FHLWMOqryAQn0H9OvyEEtsDZPmAw,4763
+hexagonal/domain/base.py,sha256=aLwbE1aQp3Cf6NO-fihuK7gS2Z-KO5jtfE7ZKAerBbs,4495
+hexagonal/domain/exceptions.py,sha256=y1fX320cNoswgJg_W1rGowHM8XY1wg5f_kkTEWVcjOk,1275
+hexagonal/entrypoints/__init__.py,sha256=Kh83vld6l4GXJEUN-LHegT2eYlq2pDvGhtO8jTCFq7s,139
+hexagonal/entrypoints/app.py,sha256=JBxj_IAPrNevS8HY6zhUR7hiGy1P22nSShorYwEXbJM,2013
+hexagonal/entrypoints/base.py,sha256=8r_s-TeD2Awzyctvx4K3UHZU5t5A2WZKmlEi0gOrjF0,3215
+hexagonal/entrypoints/bus.py,sha256=pilgSDBxwG_hL_3MaqzrHTshO_TfNkU8OHtcBmdiPYk,2044
+hexagonal/entrypoints/sqlite.py,sha256=akCp1bglcQSz-Xz2c3usPebCKD05zTzRbTSF9TMaX5s,1738
+hexagonal/ports/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hexagonal/ports/drivens/__init__.py,sha256=wERGIFEpeZScrw73Co36QwjK_icnuvKbZ7Bj_whQyQ0,897
+hexagonal/ports/drivens/application.py,sha256=9vxvR4yhwOklrtFlUZin8nmzj2xqc1Hvg5xForPBYKw,863
+hexagonal/ports/drivens/buses.py,sha256=tCEFbzA1-R8UMum2Y2hyeGd2W6jYz4bR8PJniktdZhY,4024
+hexagonal/ports/drivens/infrastructure.py,sha256=pMr9oF9mUta-hY6vv2DieQpANYCrPpwgwDQB1QMaxpc,494
+hexagonal/ports/drivens/repository.py,sha256=ijewN8988N0FTEoVtWforyeBc0ejLzBX6mDPQjJ_XE8,4096
+hexagonal/ports/drivers/__init__.py,sha256=cADln99MHC7KxZzLNc63q_VS53VSpAynvG4NUr2zDwY,86
+hexagonal/ports/drivers/app.py,sha256=QJlNYGlpNcRPWlsNVTYXIwRNi1ggRdkqvo6ElFXAsUw,1368
+hexagonal/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+python_hexagonal-0.1.0.dist-info/WHEEL,sha256=ZyFSCYkV2BrxH6-HRVRg3R9Fo7MALzer9KiPYqNxSbo,79
+python_hexagonal-0.1.0.dist-info/METADATA,sha256=OF15AlgCDDholY0Dkj_UqE27KQutCVm5djK-eU-HA14,525
+python_hexagonal-0.1.0.dist-info/RECORD,,

python_hexagonal-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.9.18
+Root-Is-Purelib: true
+Tag: py3-none-any