async_to_custom_raw_response_wrapper() — anthropic-sdk-python Function Reference

Architecture documentation for the async_to_custom_raw_response_wrapper() function in _response.py from the anthropic-sdk-python codebase.

Function python AnthropicClient AsyncAPI calls 1

Entity Profile

AnthropicClient→ AsyncAPI→ async_to_custom_raw_response_wrapper() — anthropic-sdk-python Function Reference

Dependency Diagram

graph TD
  294f3215_2763_e51b_099b_e260748b7eb3["async_to_custom_raw_response_wrapper()"]
  2e9c15bb_de03_aa91_93be_0e05db0a552e["_response.py"]
  294f3215_2763_e51b_099b_e260748b7eb3 -->|defined in| 2e9c15bb_de03_aa91_93be_0e05db0a552e
  839eb1b8_70aa_074d_a52b_fad472cf23c5["get()"]
  294f3215_2763_e51b_099b_e260748b7eb3 -->|calls| 839eb1b8_70aa_074d_a52b_fad472cf23c5
  style 294f3215_2763_e51b_099b_e260748b7eb3 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/anthropic/_response.py lines 834–854

def async_to_custom_raw_response_wrapper(
    func: Callable[P, Awaitable[object]],
    response_cls: type[_AsyncAPIResponseT],
) -> Callable[P, Awaitable[_AsyncAPIResponseT]]:
    """Higher order function that takes one of our bound API methods and an `APIResponse` class
    and wraps the method to support returning the given response class directly.

    Note: the given `response_cls` *must* be concrete, e.g. `class BinaryAPIResponse(APIResponse[bytes])`
    """

    @functools.wraps(func)
    def wrapped(*args: P.args, **kwargs: P.kwargs) -> Awaitable[_AsyncAPIResponseT]:
        extra_headers: dict[str, Any] = {**(cast(Any, kwargs.get("extra_headers")) or {})}
        extra_headers[RAW_RESPONSE_HEADER] = "raw"
        extra_headers[OVERRIDE_CAST_TO_HEADER] = response_cls

        kwargs["extra_headers"] = extra_headers

        return cast(Awaitable[_AsyncAPIResponseT], func(*args, **kwargs))

    return wrapped