httpware 0.2.0__tar.gz → 0.3.0__tar.gz

{httpware-0.2.0 → httpware-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: httpware
-Version: 0.2.0
+Version: 0.3.0
 Summary: Resilience-first async HTTP client framework for Python
 Keywords: http,async,client,resilience,retry,circuit-breaker,middleware,httpx,pydantic
 Author: Artur Shiriev
@@ -15,17 +15,18 @@ Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Framework :: AsyncIO
 Requires-Dist: httpx2>=2.0.0,<3.0
-Requires-Dist: pydantic>=2.0,<3.0
-Requires-Dist: httpware[msgspec,otel] ; extra == 'all'
+Requires-Dist: httpware[pydantic,msgspec,otel] ; extra == 'all'
 Requires-Dist: msgspec>=0.18 ; extra == 'msgspec'
 Requires-Dist: opentelemetry-api>=1.20 ; extra == 'otel'
 Requires-Dist: opentelemetry-sdk>=1.20 ; extra == 'otel'
+Requires-Dist: pydantic>=2.0,<3.0 ; extra == 'pydantic'
 Requires-Python: >=3.11, <4
 Project-URL: repository, https://github.com/modern-python/httpware
 Project-URL: docs, https://httpware.readthedocs.io
 Provides-Extra: all
 Provides-Extra: msgspec
 Provides-Extra: otel
+Provides-Extra: pydantic
 Description-Content-Type: text/markdown
 
 # httpware
@@ -37,26 +38,25 @@ Description-Content-Type: text/markdown
 
 **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.
+`httpware` is a thin opinionated wrapper around `httpx2`. It re-exports `httpx2.Request`/`httpx2.Response`, adds a middleware chain composed at client construction, supports opt-in typed response decoding (pydantic and msgspec are both extras), and raises a status-keyed exception tree automatically on 4xx/5xx.
 
-> **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.
+> **Status:** Pre-1.0 (0.3.0). 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
 
 ```bash
-pip install httpware
+pip install httpware                # core only — no decoder
+pip install httpware[pydantic]      # + PydanticDecoder (the default-decoder path)
+pip install httpware[msgspec]       # + MsgspecDecoder
+pip install httpware[all]           # everything declared above (pydantic, msgspec, otel)
 ```
 
-Optional extras:
-
-```bash
-pip install httpware[msgspec]    # MsgspecDecoder
-```
-
-(`otel`, `niquests`, and `all` extras are declared; integrations have not shipped yet.)
+`AsyncClient()` with no `decoder=` argument defaults to constructing a `PydanticDecoder`; that path requires the `pydantic` extra and raises `ImportError` at `AsyncClient.__init__` if it is missing. The `otel` extra is declared but the OpenTelemetry middleware (Epic 5) has not shipped yet.
 
 ## Quickstart
 
+> Requires: `pip install httpware[pydantic]`
+
 ```python
 from httpware import AsyncClient
 from pydantic import BaseModel

{httpware-0.2.0 → httpware-0.3.0}/README.md

@@ -7,26 +7,25 @@
 
 **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.
+`httpware` is a thin opinionated wrapper around `httpx2`. It re-exports `httpx2.Request`/`httpx2.Response`, adds a middleware chain composed at client construction, supports opt-in typed response decoding (pydantic and msgspec are both extras), and raises a status-keyed exception tree automatically on 4xx/5xx.
 
-> **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.
+> **Status:** Pre-1.0 (0.3.0). 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
 
 ```bash
-pip install httpware
+pip install httpware                # core only — no decoder
+pip install httpware[pydantic]      # + PydanticDecoder (the default-decoder path)
+pip install httpware[msgspec]       # + MsgspecDecoder
+pip install httpware[all]           # everything declared above (pydantic, msgspec, otel)
 ```
 
-Optional extras:
-
-```bash
-pip install httpware[msgspec]    # MsgspecDecoder
-```
-
-(`otel`, `niquests`, and `all` extras are declared; integrations have not shipped yet.)
+`AsyncClient()` with no `decoder=` argument defaults to constructing a `PydanticDecoder`; that path requires the `pydantic` extra and raises `ImportError` at `AsyncClient.__init__` if it is missing. The `otel` extra is declared but the OpenTelemetry middleware (Epic 5) has not shipped yet.
 
 ## Quickstart
 
+> Requires: `pip install httpware[pydantic]`
+
 ```python
 from httpware import AsyncClient
 from pydantic import BaseModel

{httpware-0.2.0 → httpware-0.3.0}/pyproject.toml

@@ -26,19 +26,19 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
     "Framework :: AsyncIO",
 ]
-version = "0.2.0"
+version = "0.3.0"
 dependencies = [
     "httpx2>=2.0.0,<3.0",
-    "pydantic>=2.0,<3.0",
 ]
 
 [project.optional-dependencies]
+pydantic = ["pydantic>=2.0,<3.0"]
 msgspec = ["msgspec>=0.18"]
 otel = [
     "opentelemetry-api>=1.20",
     "opentelemetry-sdk>=1.20",
 ]
-all = ["httpware[msgspec,otel]"]
+all = ["httpware[pydantic,msgspec,otel]"]
 
 [project.urls]
 repository = "https://github.com/modern-python/httpware"

{httpware-0.2.0 → httpware-0.3.0}/src/httpware/__init__.py

@@ -2,7 +2,6 @@
 
 from httpware.client import AsyncClient
 from httpware.decoders import ResponseDecoder
-from httpware.decoders.pydantic import PydanticDecoder
 from httpware.errors import (
     STATUS_TO_EXCEPTION,
     BadRequestError,
@@ -36,7 +35,6 @@ __all__ = [
     "Middleware",
     "Next",
     "NotFoundError",
-    "PydanticDecoder",
     "RateLimitedError",
     "ResponseDecoder",
     "ServerStatusError",

{httpware-0.2.0 → httpware-0.3.0}/src/httpware/_internal/import_checker.py

@@ -4,3 +4,4 @@ from importlib.util import find_spec
 
 
 is_msgspec_installed = find_spec("msgspec") is not None
+is_pydantic_installed = find_spec("pydantic") is not None

{httpware-0.2.0 → httpware-0.3.0}/src/httpware/client.py

@@ -6,8 +6,8 @@ from http import HTTPStatus
 
 import httpx2
 
+from httpware._internal import import_checker
 from httpware.decoders import ResponseDecoder
-from httpware.decoders.pydantic import PydanticDecoder
 from httpware.errors import (
     STATUS_TO_EXCEPTION,
     ClientStatusError,
@@ -28,6 +28,20 @@ _HTTPX2_CLIENT_CONFLICT_MESSAGE = (
     f"{_FORWARDED_KWARG_NAMES}; configure the httpx2.AsyncClient you pass instead."
 )
 
+_DEFAULT_DECODER_MISSING_MESSAGE = (
+    "AsyncClient(decoder=None) defaults to PydanticDecoder, which requires the "
+    "'pydantic' extra. Either install it (`pip install httpware[pydantic]`) or "
+    "pass an explicit decoder=..."
+)
+
+
+def _default_pydantic_decoder() -> ResponseDecoder:
+    if not import_checker.is_pydantic_installed:
+        raise ImportError(_DEFAULT_DECODER_MISSING_MESSAGE)
+    from httpware.decoders.pydantic import PydanticDecoder  # noqa: PLC0415 — lazy by design
+
+    return PydanticDecoder()
+
 
 class AsyncClient:
     """Async HTTP client: thin wrapper around httpx2 with typed decoding and middleware."""
@@ -85,7 +99,7 @@ class AsyncClient:
             self._httpx2_client = httpx2.AsyncClient(**kwargs)
             self._owns_client = True
 
-        self._decoder = decoder if decoder is not None else PydanticDecoder()
+        self._decoder = decoder if decoder is not None else _default_pydantic_decoder()
         self._user_middleware = tuple(middleware)
         self._dispatch = compose(self._user_middleware, self._terminal)
 

httpware-0.3.0/src/httpware/decoders/pydantic.py

@@ -0,0 +1,44 @@
+"""PydanticDecoder — module-level cached TypeAdapter adapter for ResponseDecoder.
+
+Requires the `pydantic` extra: `pip install httpware[pydantic]`. Importing this
+module without the extra works (the `pydantic` import is guarded by a
+`find_spec` check), but instantiating the decoder raises `ImportError` with the
+install hint.
+"""
+
+import functools
+from typing import TypeVar
+
+from httpware._internal import import_checker
+
+
+if import_checker.is_pydantic_installed:
+    from pydantic import TypeAdapter
+
+
+MISSING_DEPENDENCY_MESSAGE = (
+    "PydanticDecoder requires the 'pydantic' extra. Install with: pip install httpware[pydantic]"
+)
+
+T = TypeVar("T")
+
+
+@functools.lru_cache(maxsize=1024)
+def _get_adapter(model: type[T]) -> "TypeAdapter[T]":
+    return TypeAdapter(model)
+
+
+class PydanticDecoder:
+    """Decode raw response bytes into `model` via a cached `pydantic.TypeAdapter`."""
+
+    def __init__(self) -> None:
+        if not import_checker.is_pydantic_installed:
+            raise ImportError(MISSING_DEPENDENCY_MESSAGE)
+
+    def decode(self, content: bytes, model: type[T]) -> T:
+        """Validate `content` as JSON against `model` in a single parse pass."""
+        try:
+            adapter = _get_adapter(model)
+        except TypeError:
+            adapter = TypeAdapter(model)
+        return adapter.validate_json(content)

httpware-0.2.0/src/httpware/decoders/pydantic.py

@@ -1,29 +0,0 @@
-"""PydanticDecoder — module-level cached TypeAdapter adapter for ResponseDecoder."""
-
-import functools
-from typing import TypeVar
-
-from pydantic import TypeAdapter
-
-
-T = TypeVar("T")
-
-
-@functools.lru_cache(maxsize=1024)
-def _get_adapter(model: type[T]) -> TypeAdapter[T]:
-    return TypeAdapter(model)
-
-
-class PydanticDecoder:
-    """Decode raw response bytes into `model` via a cached `pydantic.TypeAdapter`."""
-
-    def decode(self, content: bytes, model: type[T]) -> T:
-        """Validate `content` as JSON against `model` in a single parse pass."""
-        try:
-            adapter = _get_adapter(model)
-        except TypeError:
-            adapter = TypeAdapter(model)
-        return adapter.validate_json(content)
-
-
-__all__ = ["PydanticDecoder"]