Skip to content

Port

_port

Abstract base class for the port hierarchy.

Defines the root Port class, which all ports ultimately inherit from.
Application code should subclass InboundPort or OutboundPort
instead of Port directly, as Port itself enforces no
dependency-direction rules.

Port

Bases: ABC

Root abstract base class for all port contracts.
Responsibilities:
- Serve as the root abstract base for all port contracts.
- Define the contract that InboundPort and OutboundPort
concretize.

Non-Responsibilities
  • Does NOT enforce dependency-direction rules — that is delegated
    to InboundPort and OutboundPort via __init_subclass__.
Example 
class CreateUserPort(Port):
    @classmethod
    def __init_subclass__(cls, /) -> None: ...
    def execute(self, name: str) -> str: ...
Source code in src/forging_blocks/foundation/ports/_port.py 
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
class Port(ABC, metaclass=FinalABCMeta):
    """Root abstract base class for all port contracts.
    Responsibilities:
        - Serve as the root abstract base for all port contracts.
        - Define the contract that ``InboundPort`` and ``OutboundPort``
          concretize.

    Non-Responsibilities:
        - Does NOT enforce dependency-direction rules — that is delegated
          to ``InboundPort`` and ``OutboundPort`` via ``__init_subclass__``.

    Example:
        ```python
        class CreateUserPort(Port):
            @classmethod
            def __init_subclass__(cls, /) -> None: ...
            def execute(self, name: str) -> str: ...
        ```
    """

    @classmethod
    @abstractmethod
    def __init_subclass__(cls, /) -> None:
        super().__init_subclass__()