Skip to content

Response Adapter

response_adapter

Protocol for translating application output into transport-level responses.

ResponseAdapter

Bases: Protocol

Translates application-layer output into a transport response.

Implementations handle transport-specific serialization (e.g.
JSON encoding, setting HTTP status headers, formatting CLI
output) and produce the raw response type consumed by the
transport framework.

Source code in src/forging_blocks/presentation/response_adapter.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
class ResponseAdapter[UseCaseOutput, RawResponse](Protocol):
    """Translates application-layer output into a transport response.

    Implementations handle transport-specific serialization (e.g.
    JSON encoding, setting HTTP status headers, formatting CLI
    output) and produce the raw response type consumed by the
    transport framework.
    """

    def adapt(self, output: UseCaseOutput) -> RawResponse:
        """Convert successful use-case output into a transport response.

        Args:
            output: The value returned by ``UseCase.execute`` on
                success.

        Returns:
            A transport-level response ready to send to the caller.
        """
        ...

    def adapt_error(self, view_model: ErrorViewModel) -> RawResponse:
        """Convert an ``ErrorViewModel`` into a transport error response.

        Args:
            view_model: The error view model produced by
                ``ErrorPresenter.to_view_model``, optionally enriched
                with status codes by ``ErrorStatusCodeMapper``.

        Returns:
            A transport-level error response (e.g. an HTTP response
            with the appropriate status code and JSON body).
        """
        ...

adapt(output: UseCaseOutput) -> RawResponse

Convert successful use-case output into a transport response.

Parameters:

Name Type Description Default
output UseCaseOutput

The value returned by UseCase.execute on
success.

 required

Returns:

Type Description
RawResponse

A transport-level response ready to send to the caller.
Source code in src/forging_blocks/presentation/response_adapter.py 
17
18
19
20
21
22
23
24
25
26
27
def adapt(self, output: UseCaseOutput) -> RawResponse:
    """Convert successful use-case output into a transport response.

    Args:
        output: The value returned by ``UseCase.execute`` on
            success.

    Returns:
        A transport-level response ready to send to the caller.
    """
    ...

adapt_error(view_model: ErrorViewModel) -> RawResponse

Convert an ErrorViewModel into a transport error response.

Parameters:

Name Type Description Default
view_model ErrorViewModel

The error view model produced by
ErrorPresenter.to_view_model, optionally enriched
with status codes by ErrorStatusCodeMapper.

 required

Returns:

Type Description
RawResponse

A transport-level error response (e.g. an HTTP response
RawResponse

with the appropriate status code and JSON body).
Source code in src/forging_blocks/presentation/response_adapter.py 
29
30
31
32
33
34
35
36
37
38
39
40
41
def adapt_error(self, view_model: ErrorViewModel) -> RawResponse:
    """Convert an ``ErrorViewModel`` into a transport error response.

    Args:
        view_model: The error view model produced by
            ``ErrorPresenter.to_view_model``, optionally enriched
            with status codes by ``ErrorStatusCodeMapper``.

    Returns:
        A transport-level error response (e.g. an HTTP response
        with the appropriate status code and JSON body).
    """
    ...