alt-stack-http-client-httpx

Asyncio HTTP client for Python SDKs generated by alt-stack-openapi-pydantic. It is the Python counterpart of @alt-stack/http-client-core and @alt-stack/http-client-fetch: request inputs are validated and encoded with the SDK's Request map, responses are validated with its Response map, and results come back as a small discriminated union.

Install

python -m pip install alt-stack-http-client-httpx

Generated SDK modules import alt_stack_http_client_httpx at runtime, so SDK consumers install this package. The generator itself is a development-time dependency.

Use a generated SDK

from alt_stack_http_client_httpx import ApiFailure, ApiSuccess

from generated_types import GetUsersIdParams, HttpxApiClient, Request, Response

async with HttpxApiClient(
    "https://api.example.com", request_map=Request, response_map=Response
) as client:
    result = await client.get("/users/{id}", params=GetUsersIdParams(id="u_1"))

if isinstance(result, ApiSuccess):
    result.body  # User
elif isinstance(result, ApiFailure):
    result.error  # documented error model
else:
    result.error  # UnexpectedApiClientError

Importing HttpxApiClient from the generated module gives one typed method per route. Importing it from alt_stack_http_client_httpx accepts the same arguments and exposes the untyped request(method, path, ...) API with runtime validation.

Bring your own transport

BaseApiClient sends through the Transport protocol, a single async def send(request: HttpRequest) -> HttpResponse. Implement it over any asyncio HTTP library and pass it to the generated ApiClient(base_url, transport=..., request_map=Request, response_map=Response).

Scalar query floats with an integral value use integer spelling (10.0 becomes limit=10); fractional values keep their decimal spelling (2.5). Strings, booleans, repeated list values, omitted None values, and JSON bodies retain their existing encoding.

Development

uv sync --project packages/python-http-client-httpx --extra dev
packages/python-http-client-httpx/.venv/bin/pytest packages/python-http-client-httpx/tests -q
packages/python-http-client-httpx/.venv/bin/ruff check packages/python-http-client-httpx
packages/python-http-client-httpx/.venv/bin/ty check packages/python-http-client-httpx

Documentation

• Python/Pydantic API Documentation