Skip to content

Logger Port

logger_port

LoggerPort port for abstract logging.

Defines the LoggerPort protocol that application code depends on,
decoupling logging from any specific logging library.

LoggerPort

Bases: OutboundPort[object, object], Protocol

Structural protocol for logging.

Any object with debug, info, warning, and error
methods that accept a message string plus optional positional
arguments satisfies this protocol — no inheritance required.

Source code in src/forging_blocks/application/ports/outbound/logger_port.py 
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
class LoggerPort(OutboundPort[object, object], Protocol):
    """Structural protocol for logging.

    Any object with ``debug``, ``info``, ``warning``, and ``error``
    methods that accept a message string plus optional positional
    arguments satisfies this protocol — no inheritance required.
    """

    def debug(self, msg: str, *args: object) -> None:
        """Log a debug message."""
        ...

    def info(self, msg: str, *args: object) -> None:
        """Log an info message."""
        ...

    def warning(self, msg: str, *args: object) -> None:
        """Log a warning message."""
        ...

    def error(self, msg: str, *args: object) -> None:
        """Log an error message."""
        ...

debug(msg: str, *args: object) -> None

Log a debug message.

Source code in src/forging_blocks/application/ports/outbound/logger_port.py 
20
21
22
def debug(self, msg: str, *args: object) -> None:
    """Log a debug message."""
    ...

info(msg: str, *args: object) -> None

Log an info message.

Source code in src/forging_blocks/application/ports/outbound/logger_port.py 
24
25
26
def info(self, msg: str, *args: object) -> None:
    """Log an info message."""
    ...

warning(msg: str, *args: object) -> None

Log a warning message.

Source code in src/forging_blocks/application/ports/outbound/logger_port.py 
28
29
30
def warning(self, msg: str, *args: object) -> None:
    """Log a warning message."""
    ...

error(msg: str, *args: object) -> None

Log an error message.

Source code in src/forging_blocks/application/ports/outbound/logger_port.py 
32
33
34
def error(self, msg: str, *args: object) -> None:
    """Log an error message."""
    ...