reflectapi-runtime 0.18.0__tar.gz → 0.20.0__tar.gz

{reflectapi_runtime-0.18.0 → reflectapi_runtime-0.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: reflectapi-runtime
-Version: 0.18.0
+Version: 0.20.0
 Summary: Runtime library for ReflectAPI Python clients
 Project-URL: Homepage, https://github.com/thepartly/reflectapi
 Project-URL: Repository, https://github.com/thepartly/reflectapi
@@ -19,9 +19,13 @@ Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.12
-Requires-Dist: httpx>=0.25.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: typing-extensions>=4.4.0
+Requires-Dist: anyio>=4.14.2
+Requires-Dist: httpcore>=1.0.9
+Requires-Dist: httpx>=0.25.2
+Requires-Dist: idna>=3.15
+Requires-Dist: pydantic>=2.10.0; python_version < '3.14'
+Requires-Dist: pydantic>=2.12.0; python_version >= '3.14'
+Requires-Dist: typing-extensions>=4.5.0
 Provides-Extra: dev
 Requires-Dist: hypothesis>=6.0.0; extra == 'dev'
 Requires-Dist: mypy>=1.5.0; extra == 'dev'
@@ -47,8 +51,12 @@ directly.
 - `ClientBase` / `AsyncClientBase` — base classes used by the generated
   `Client` / `AsyncClient`. They wrap `httpx` and handle request build-up,
   Pydantic-based response validation, and middleware.
-- `ApiResponse[T, E]` — typed wrapper around the response value, transport
-  metadata, and the optional typed error.
+- `ApiResponse[T, E, H]` — typed wrapper around the response value, transport
+  metadata, the optional typed error, and the API's declared response headers
+  (`.headers`).
+- `ApiStream[T, H]` / `AsyncApiStream[T, H]` — iterators returned by streaming
+  methods, exposing the response's `metadata` and declared `headers` once
+  iteration starts.
 - `ApplicationError`, `NetworkError`, `TimeoutError`, `ValidationError` —
   exceptions raised by the generated methods on non-2xx, transport, and
   validation failures respectively.
@@ -77,12 +85,15 @@ against the declared item model. The wire format is Server-Sent Events
 do not enter the iterator. Breaking out of the loop or calling
 `stream.aclose()` releases the underlying HTTP connection.
 
-Validation is strict: an event whose payload doesn't match the item model
-(for example, an unknown discriminated-union variant added by a newer
-server) raises `ValidationError` mid-stream and the iterator terminates.
-Items received before the bad event are still delivered.
+Events are validated against the generated model. Closed response enums reject
+unfamiliar variants; enums declared with `#[reflectapi(open)]` retain them as
+an unknown case with the tag and parsed JSON, and `#[serde(other)]` uses the
+declared fallback. A malformed known variant raises `ValidationError`
+mid-stream and terminates the iterator. Earlier items remain delivered.
 
 ## Compatibility
 
-Python 3.12+. The package targets the same `reflectapi` minor version as
-the schema you generate from; mismatches will surface at import time.
+Python 3.12+. SDKs generated with ReflectAPI 0.20 require the 0.20 runtime.
+Pydantic 2.10 or newer supports the generated generic models; Python 3.14
+requires Pydantic 2.12 or newer. Installing the runtime resolves these requirements
+and the supported HTTP dependencies automatically.

{reflectapi_runtime-0.18.0 → reflectapi_runtime-0.20.0}/README.md

@@ -10,8 +10,12 @@ directly.
 - `ClientBase` / `AsyncClientBase` — base classes used by the generated
   `Client` / `AsyncClient`. They wrap `httpx` and handle request build-up,
   Pydantic-based response validation, and middleware.
-- `ApiResponse[T, E]` — typed wrapper around the response value, transport
-  metadata, and the optional typed error.
+- `ApiResponse[T, E, H]` — typed wrapper around the response value, transport
+  metadata, the optional typed error, and the API's declared response headers
+  (`.headers`).
+- `ApiStream[T, H]` / `AsyncApiStream[T, H]` — iterators returned by streaming
+  methods, exposing the response's `metadata` and declared `headers` once
+  iteration starts.
 - `ApplicationError`, `NetworkError`, `TimeoutError`, `ValidationError` —
   exceptions raised by the generated methods on non-2xx, transport, and
   validation failures respectively.
@@ -40,12 +44,15 @@ against the declared item model. The wire format is Server-Sent Events
 do not enter the iterator. Breaking out of the loop or calling
 `stream.aclose()` releases the underlying HTTP connection.
 
-Validation is strict: an event whose payload doesn't match the item model
-(for example, an unknown discriminated-union variant added by a newer
-server) raises `ValidationError` mid-stream and the iterator terminates.
-Items received before the bad event are still delivered.
+Events are validated against the generated model. Closed response enums reject
+unfamiliar variants; enums declared with `#[reflectapi(open)]` retain them as
+an unknown case with the tag and parsed JSON, and `#[serde(other)]` uses the
+declared fallback. A malformed known variant raises `ValidationError`
+mid-stream and terminates the iterator. Earlier items remain delivered.
 
 ## Compatibility
 
-Python 3.12+. The package targets the same `reflectapi` minor version as
-the schema you generate from; mismatches will surface at import time.
+Python 3.12+. SDKs generated with ReflectAPI 0.20 require the 0.20 runtime.
+Pydantic 2.10 or newer supports the generated generic models; Python 3.14
+requires Pydantic 2.12 or newer. Installing the runtime resolves these requirements
+and the supported HTTP dependencies automatically.

{reflectapi_runtime-0.18.0 → reflectapi_runtime-0.20.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "reflectapi-runtime"
-version = "0.18.0"
+version = "0.20.0"
 description = "Runtime library for ReflectAPI Python clients"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -26,9 +26,13 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "pydantic>=2.0.0",
-    "httpx>=0.25.0",
-    "typing-extensions>=4.4.0",
+    "pydantic>=2.10.0; python_version < '3.14'",
+    "pydantic>=2.12.0; python_version >= '3.14'",
+    "httpx>=0.25.2",
+    "httpcore>=1.0.9",
+    "anyio>=4.14.2",
+    "idna>=3.15",
+    "typing-extensions>=4.5.0",
 ]
 
 [project.optional-dependencies]

{reflectapi_runtime-0.18.0 → reflectapi_runtime-0.20.0}/src/reflectapi_runtime/__init__.py

@@ -38,8 +38,13 @@ from .hypothesis_strategies import (
 )
 from .middleware import AsyncMiddleware
 from .partial import ReflectapiPartialModel
-from .response import ApiResponse, TransportMetadata
-from .serde import parse_externally_tagged, serialize_externally_tagged
+from .response import ApiResponse, ApiStream, AsyncApiStream, TransportMetadata
+from .serde import (
+    UnknownEnumValue,
+    classify_tagged_enum,
+    parse_externally_tagged,
+    serialize_externally_tagged,
+)
 from .streaming import AsyncStreamingClient, StreamingResponse
 from .testing import (
     AsyncCassetteMiddleware,
@@ -50,7 +55,7 @@ from .testing import (
 )
 from .types import BatchResult, ReflectapiEmpty, ReflectapiInfallible
 
-__version__ = "0.18.0"
+__version__ = "0.20.0"
 
 __all__ = [
     # Authentication
@@ -93,7 +98,11 @@ __all__ = [
     "ReflectapiPartialModel",
     "parse_externally_tagged",
     "serialize_externally_tagged",
+    "UnknownEnumValue",
+    "classify_tagged_enum",
     "StreamingResponse",
+    "ApiStream",
+    "AsyncApiStream",
     "TestClientMixin",
     "TimeoutError",
     "TransportMetadata",