httpware 0.8.0__tar.gz → 0.8.1__tar.gz

{httpware-0.8.0 → httpware-0.8.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.8.0
+Version: 0.8.1
 Summary: Resilience-first async HTTP client framework for Python
 Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
 Author: Artur Shiriev
@@ -79,7 +79,7 @@ with Client(base_url="https://example.test") as client:
     print(response.json())
 ```
 
-Typed decoding via `response_model=` works in both worlds — requires `pip install httpware[pydantic]`:
+Typed decoding via `response_model=` works in both worlds — requires `pip install httpware[pydantic]`. Decode failures (malformed body, schema mismatch) raise `httpware.DecodeError`, a `ClientError` subclass — so `except httpware.ClientError` covers them alongside transport and status errors.
 
 ```python
 from httpware import AsyncClient

{httpware-0.8.0 → httpware-0.8.1}/README.md

@@ -49,7 +49,7 @@ with Client(base_url="https://example.test") as client:
     print(response.json())
 ```
 
-Typed decoding via `response_model=` works in both worlds — requires `pip install httpware[pydantic]`:
+Typed decoding via `response_model=` works in both worlds — requires `pip install httpware[pydantic]`. Decode failures (malformed body, schema mismatch) raise `httpware.DecodeError`, a `ClientError` subclass — so `except httpware.ClientError` covers them alongside transport and status errors.
 
 ```python
 from httpware import AsyncClient

{httpware-0.8.0 → httpware-0.8.1}/pyproject.toml

@@ -26,7 +26,7 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.8.0"
+version = "0.8.1"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
 ]

{httpware-0.8.0 → httpware-0.8.1}/src/httpware/__init__.py

@@ -9,6 +9,7 @@ from httpware.errors import (
     ClientError,
     ClientStatusError,
     ConflictError,
+    DecodeError,
     ForbiddenError,
     InternalServerError,
     NetworkError,
@@ -52,6 +53,7 @@ __all__ = [
     "ClientError",
     "ClientStatusError",
     "ConflictError",
+    "DecodeError",
     "ForbiddenError",
     "InternalServerError",
     "Middleware",

{httpware-0.8.0 → httpware-0.8.1}/src/httpware/client.py

@@ -16,7 +16,7 @@ from httpware._internal.status import (
     _raise_on_status_error,
 )
 from httpware.decoders import ResponseDecoder
-from httpware.errors import TransportError
+from httpware.errors import DecodeError, TransportError
 from httpware.middleware import AsyncMiddleware, AsyncNext, Middleware, Next
 from httpware.middleware.chain import compose, compose_async
 
@@ -154,7 +154,10 @@ class AsyncClient:
         response = await self._dispatch(request)
         if response_model is None:
             return response
-        return self._decoder.decode(response.content, response_model)
+        try:
+            return self._decoder.decode(response.content, response_model)
+        except Exception as exc:
+            raise DecodeError(response=response, model=response_model, original=exc) from exc
 
     def build_request(self, method: str, url: str, **kwargs: typing.Any) -> httpx2.Request:
         """Delegate request construction to the wrapped httpx2.AsyncClient."""
@@ -871,7 +874,10 @@ class Client:
         response = self._dispatch(request)
         if response_model is None:
             return response
-        return self._decoder.decode(response.content, response_model)
+        try:
+            return self._decoder.decode(response.content, response_model)
+        except Exception as exc:
+            raise DecodeError(response=response, model=response_model, original=exc) from exc
 
     def build_request(self, method: str, url: str, **kwargs: typing.Any) -> httpx2.Request:
         """Delegate request construction to the wrapped httpx2.Client."""

{httpware-0.8.0 → httpware-0.8.1}/src/httpware/decoders/__init__.py

@@ -11,7 +11,12 @@ class ResponseDecoder(Protocol):
     """Structural protocol every response-body decoder satisfies."""
 
     def decode(self, content: bytes, model: type[T]) -> T:
-        """Decode `content` (raw response bytes) into an instance of `model`."""
+        """Decode `content` (raw response bytes) into an instance of `model`.
+
+        Any exception raised by `decode` is wrapped by `Client.send` /
+        `AsyncClient.send` into `httpware.DecodeError`; implementers do not
+        need to raise `DecodeError` directly.
+        """
         ...
 
 

{httpware-0.8.0 → httpware-0.8.1}/src/httpware/errors.py

@@ -212,3 +212,45 @@ class BulkheadFullError(ClientError):
             _reconstruct_bulkhead_full,
             (type(self), self.max_concurrent, self.acquire_timeout),
         )
+
+
+def _reconstruct_decode_error(
+    cls: "type[DecodeError]",
+    response: httpx2.Response,
+    model: type,
+    original: BaseException,
+) -> "DecodeError":
+    return cls(response=response, model=model, original=original)
+
+
+class DecodeError(ClientError):
+    """Raised when the active ResponseDecoder failed to decode response.content.
+
+    The HTTP call itself succeeded — status was 2xx/3xx and the transport
+    delivered the body intact — but the body could not be parsed into the
+    requested response_model. Always chained from the underlying library
+    exception via ``raise ... from exc``; that exception is also exposed as
+    ``self.original`` for structured handling.
+    """
+
+    response: httpx2.Response
+    model: type
+    original: BaseException
+
+    def __init__(
+        self,
+        *,
+        response: httpx2.Response,
+        model: type,
+        original: BaseException,
+    ) -> None:
+        self.response = response
+        self.model = model
+        self.original = original
+        super().__init__(f"failed to decode response into {model.__name__}: {original}")
+
+    def __reduce__(self) -> tuple[Any, ...]:
+        return (
+            _reconstruct_decode_error,
+            (type(self), self.response, self.model, self.original),
+        )