Request Adapter

request_adapter

Protocol for translating transport-level requests into application input.

RequestAdapter

Bases: Protocol

Translates a raw transport request into application-layer input.

Implementations handle transport-specific deserialization (e.g.
parsing JSON bodies, extracting headers, normalising query
parameters) and produce a typed use-case input DTO or command.

Example

class JsonRequestAdapter:
    def adapt(self, raw: object) -> object:
        return {}


adapter = JsonRequestAdapter()
input_dto = adapter.adapt(http_request)
# input_dto is a CreateOrderInput instance

Source code in src/forging_blocks/presentation/adapters/request_adapter.py

class RequestAdapter[RawRequest, UseCaseInput](Protocol):
    """Translates a raw transport request into application-layer input.

    Implementations handle transport-specific deserialization (e.g.
    parsing JSON bodies, extracting headers, normalising query
    parameters) and produce a typed use-case input DTO or command.

    Example:
        ```python
        class JsonRequestAdapter:
            def adapt(self, raw: object) -> object:
                return {}


        adapter = JsonRequestAdapter()
        input_dto = adapter.adapt(http_request)
        # input_dto is a CreateOrderInput instance
        ```
    """

    def adapt(self, raw: RawRequest) -> UseCaseInput:
        """Convert *raw* transport data into use-case input.

        Args:
            raw: The transport-level request (e.g. an HTTP request
                object, a CLI argv tuple, or a raw dictionary).

        Returns:
            A typed input value suitable for passing to a
            ``UseCasePort.execute`` call.

        """
        ...

adapt(raw: RawRequest) -> UseCaseInput

Convert raw transport data into use-case input.

Parameters:

Name	Type	Description	Default
raw	RawRequest	The transport-level request (e.g. an HTTP request object, a CLI argv tuple, or a raw dictionary).	required

Returns:

Type	Description
UseCaseInput	A typed input value suitable for passing to a
UseCaseInput	UseCasePort.execute call.

Source code in src/forging_blocks/presentation/adapters/request_adapter.py

def adapt(self, raw: RawRequest) -> UseCaseInput:
    """Convert *raw* transport data into use-case input.

    Args:
        raw: The transport-level request (e.g. an HTTP request
            object, a CLI argv tuple, or a raw dictionary).

    Returns:
        A typed input value suitable for passing to a
        ``UseCasePort.execute`` call.

    """
    ...