httpware 0.2.0

Resilience-first async HTTP client framework for Python

httpware

Async HTTP client framework for Python.

httpware is a typed, async HTTP client library with a protocol-based seam so the transport is swappable (httpx2 ships as the default). Middleware composes via an onion model. Pydantic and msgspec response decoding ship out of the box. RecordedTransport replaces respx for transport-level tests.

Status: Pre-1.0 (0.1.0 alpha). Public API is subject to change between minor releases until v1.0. Resilience middleware (retry / timeout / bulkhead), streaming, and observability are not yet shipped.

Install

pip install httpware

Optional extras:

pip install httpware[msgspec]    # MsgspecDecoder

(otel, niquests, and all extras are declared; integrations have not shipped yet.)

Quickstart

from httpware import AsyncClient
from pydantic import BaseModel


class User(BaseModel):
    id: int
    name: str


async def main() -> None:
    async with AsyncClient(base_url="https://api.example.com") as client:
        user = await client.get("/users/1", response_model=User)
        print(user.name)

📚 Documentation

📦 PyPI

📝 License

Part of modern-python

Browse the full list of templates and libraries in modern-python — see the org profile for the categorized index.