Function encode_request

httpx/_content.py:186–218

Handles encoding the given `content`, `data`, `files`, and `json`, returning a two-tuple of (<headers>, <stream>).

(
    content: RequestContent | None = None,
    data: RequestData | None = None,
    files: RequestFiles | None = None,
    json: Any | None = None,
    boundary: bytes | None = None,
)

def encode_request(
    content: RequestContent | None = None,
    data: RequestData | None = None,
    files: RequestFiles | None = None,
    json: Any | None = None,
    boundary: bytes | None = None,
) -> tuple[dict[str, str], SyncByteStream | AsyncByteStream]:
    class="st">"""
    Handles encoding the given `content`, `data`, `files`, and `json`,
    returning a two-tuple of (<headers>, <stream>).
    class="st">"""
    if data is not None and not isinstance(data, Mapping):
        class="cm"># We prefer to separate `content=<bytes|str|byte iterator|bytes aiterator>`
        class="cm"># for raw request content, and `data=<form data>` for url encoded or
        class="cm"># multipart form content.
        class="cm">#
        class="cm"># However for compat with requests, we *do* still support
        class="cm"># `data=<bytes...>` usages. We deal with that case here, treating it
        class="cm"># as if `content=<...>` had been supplied instead.
        message = class="st">"Use &class="cm">#x27;content=<...>' to upload raw bytes/text content."
        warnings.warn(message, DeprecationWarning, stacklevel=2)
        return encode_content(data)

    if content is not None:
        return encode_content(content)
    elif files:
        return encode_multipart_data(data or {}, files, boundary)
    elif data:
        return encode_urlencoded_data(data)
    elif json is not None:
        return encode_json(json)

    return {}, ByteStream(bclass="st">"")


def encode_response(