samplehc 0.18.0__tar.gz → 0.19.0__tar.gz

samplehc-0.19.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.19.0"
+}

{samplehc-0.18.0 → samplehc-0.19.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.19.0 (2026-02-03)
+
+Full Changelog: [v0.18.0...v0.19.0](https://github.com/samplehc/samplehc-python/compare/v0.18.0...v0.19.0)
+
+### Features
+
+* **api:** api update ([5690ad0](https://github.com/samplehc/samplehc-python/commit/5690ad076a7117489783a902c86823bd131007e0))
+* **api:** api update ([907015e](https://github.com/samplehc/samplehc-python/commit/907015e44e80c084a433cc168cbbd3f8936de9a8))
+* **api:** api update ([a894f7d](https://github.com/samplehc/samplehc-python/commit/a894f7dfb69e26535b858f010a47664a2649ffc8))
+* **client:** add custom JSON encoder for extended type support ([61b182a](https://github.com/samplehc/samplehc-python/commit/61b182a434c0b6488cd1d64bd8aeaafe4ef6c477))
+
+
+### Chores
+
+* **ci:** upgrade `actions/github-script` ([17e3e4f](https://github.com/samplehc/samplehc-python/commit/17e3e4fb991e6fd0a6fd9adcb9f50eea85e3046c))
+
 ## 0.18.0 (2026-01-23)
 
 Full Changelog: [v0.17.0...v0.18.0](https://github.com/samplehc/samplehc-python/compare/v0.17.0...v0.18.0)

{samplehc-0.18.0 → samplehc-0.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: samplehc
-Version: 0.18.0
+Version: 0.19.0
 Summary: The official Python library for the Sample Healthcare API
 Project-URL: Homepage, https://github.com/samplehc/samplehc-python
 Project-URL: Repository, https://github.com/samplehc/samplehc-python

{samplehc-0.18.0 → samplehc-0.19.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "samplehc"
-version = "0.18.0"
+version = "0.19.0"
 description = "The official Python library for the Sample Healthcare API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{samplehc-0.18.0 → samplehc-0.19.0}/src/samplehc/_base_client.py

@@ -86,6 +86,7 @@ from ._exceptions import (
     APIConnectionError,
     APIResponseValidationError,
 )
+from ._utils._json import openapi_dumps
 
 log: logging.Logger = logging.getLogger(__name__)
 
@@ -554,8 +555,10 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
                 kwargs["content"] = options.content
             elif isinstance(json_data, bytes):
                 kwargs["content"] = json_data
-            else:
-                kwargs["json"] = json_data if is_given(json_data) else None
+            elif not files:
+                # Don't set content when JSON is sent as multipart/form-data,
+                # since httpx's content param overrides other body arguments
+                kwargs["content"] = openapi_dumps(json_data) if is_given(json_data) and json_data is not None else None
             kwargs["files"] = files
         else:
             headers.pop("Content-Type", None)

{samplehc-0.18.0 → samplehc-0.19.0}/src/samplehc/_compat.py

@@ -139,6 +139,7 @@ def model_dump(
     exclude_defaults: bool = False,
     warnings: bool = True,
     mode: Literal["json", "python"] = "python",
+    by_alias: bool | None = None,
 ) -> dict[str, Any]:
     if (not PYDANTIC_V1) or hasattr(model, "model_dump"):
         return model.model_dump(
@@ -148,13 +149,12 @@ def model_dump(
             exclude_defaults=exclude_defaults,
             # warnings are not supported in Pydantic v1
             warnings=True if PYDANTIC_V1 else warnings,
+            by_alias=by_alias,
         )
     return cast(
         "dict[str, Any]",
         model.dict(  # pyright: ignore[reportDeprecated, reportUnnecessaryCast]
-            exclude=exclude,
-            exclude_unset=exclude_unset,
-            exclude_defaults=exclude_defaults,
+            exclude=exclude, exclude_unset=exclude_unset, exclude_defaults=exclude_defaults, by_alias=bool(by_alias)
         ),
     )
 

samplehc-0.19.0/src/samplehc/_utils/_json.py

@@ -0,0 +1,35 @@
+import json
+from typing import Any
+from datetime import datetime
+from typing_extensions import override
+
+import pydantic
+
+from .._compat import model_dump
+
+
+def openapi_dumps(obj: Any) -> bytes:
+    """
+    Serialize an object to UTF-8 encoded JSON bytes.
+
+    Extends the standard json.dumps with support for additional types
+    commonly used in the SDK, such as `datetime`, `pydantic.BaseModel`, etc.
+    """
+    return json.dumps(
+        obj,
+        cls=_CustomEncoder,
+        # Uses the same defaults as httpx's JSON serialization
+        ensure_ascii=False,
+        separators=(",", ":"),
+        allow_nan=False,
+    ).encode()
+
+
+class _CustomEncoder(json.JSONEncoder):
+    @override
+    def default(self, o: Any) -> Any:
+        if isinstance(o, datetime):
+            return o.isoformat()
+        if isinstance(o, pydantic.BaseModel):
+            return model_dump(o, exclude_unset=True, mode="json", by_alias=True)
+        return super().default(o)

{samplehc-0.18.0 → samplehc-0.19.0}/src/samplehc/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "samplehc"
-__version__ = "0.18.0"  # x-release-please-version
+__version__ = "0.19.0"  # x-release-please-version

{samplehc-0.18.0 → samplehc-0.19.0}/src/samplehc/resources/v2/documents/documents.py

@@ -278,8 +278,26 @@ class DocumentsResource(SyncAPIResource):
         documents: Iterable[document_extract_params.Document],
         prompt: str,
         response_json_schema: Dict[str, object],
-        model: Literal["reasoning-3-mini", "reasoning-3", "base-5", "base-5-mini", "base-5-nano"] | Omit = omit,
+        model: Literal[
+            "reasoning-3-mini",
+            "reasoning-3",
+            "base-5",
+            "base-5-mini",
+            "base-5-nano",
+            "base-4.1",
+            "base-4.1-mini",
+            "base-4.1-nano",
+            "base-5.2",
+            "base-5.2-chat-latest",
+            "gemini-3-pro",
+            "gemini-3-flash",
+            "gemini-2.5-pro",
+            "gemini-2.5-flash",
+            "gemini-2.5-flash-lite",
+        ]
+        | Omit = omit,
         ocr_enhance: document_extract_params.OcrEnhance | Omit = omit,
+        ocr_quality: Literal["high", "low"] | Omit = omit,
         priority: Literal["interactive", "non-interactive"] | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -304,6 +322,8 @@ class DocumentsResource(SyncAPIResource):
 
           ocr_enhance: OCR enhancement configuration for figure and text analysis.
 
+          ocr_quality: OCR quality setting
+
           priority: The priority of the extraction task. Non-interactive is lower priority.
 
           reasoning_effort: Optional control over the reasoning effort for extraction.
@@ -325,6 +345,7 @@ class DocumentsResource(SyncAPIResource):
                     "response_json_schema": response_json_schema,
                     "model": model,
                     "ocr_enhance": ocr_enhance,
+                    "ocr_quality": ocr_quality,
                     "priority": priority,
                     "reasoning_effort": reasoning_effort,
                 },
@@ -850,8 +871,26 @@ class AsyncDocumentsResource(AsyncAPIResource):
         documents: Iterable[document_extract_params.Document],
         prompt: str,
         response_json_schema: Dict[str, object],
-        model: Literal["reasoning-3-mini", "reasoning-3", "base-5", "base-5-mini", "base-5-nano"] | Omit = omit,
+        model: Literal[
+            "reasoning-3-mini",
+            "reasoning-3",
+            "base-5",
+            "base-5-mini",
+            "base-5-nano",
+            "base-4.1",
+            "base-4.1-mini",
+            "base-4.1-nano",
+            "base-5.2",
+            "base-5.2-chat-latest",
+            "gemini-3-pro",
+            "gemini-3-flash",
+            "gemini-2.5-pro",
+            "gemini-2.5-flash",
+            "gemini-2.5-flash-lite",
+        ]
+        | Omit = omit,
         ocr_enhance: document_extract_params.OcrEnhance | Omit = omit,
+        ocr_quality: Literal["high", "low"] | Omit = omit,
         priority: Literal["interactive", "non-interactive"] | Omit = omit,
         reasoning_effort: Literal["low", "medium", "high"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -876,6 +915,8 @@ class AsyncDocumentsResource(AsyncAPIResource):
 
           ocr_enhance: OCR enhancement configuration for figure and text analysis.
 
+          ocr_quality: OCR quality setting
+
           priority: The priority of the extraction task. Non-interactive is lower priority.
 
           reasoning_effort: Optional control over the reasoning effort for extraction.
@@ -897,6 +938,7 @@ class AsyncDocumentsResource(AsyncAPIResource):
                     "response_json_schema": response_json_schema,
                     "model": model,
                     "ocr_enhance": ocr_enhance,
+                    "ocr_quality": ocr_quality,
                     "priority": priority,
                     "reasoning_effort": reasoning_effort,
                 },

{samplehc-0.18.0 → samplehc-0.19.0}/src/samplehc/types/v2/document_extract_params.py

@@ -27,12 +27,31 @@ class DocumentExtractParams(TypedDict, total=False):
     response_json_schema: Required[Annotated[Dict[str, object], PropertyInfo(alias="responseJsonSchema")]]
     """A JSON schema defining the structure of the desired extraction output."""
 
-    model: Literal["reasoning-3-mini", "reasoning-3", "base-5", "base-5-mini", "base-5-nano"]
+    model: Literal[
+        "reasoning-3-mini",
+        "reasoning-3",
+        "base-5",
+        "base-5-mini",
+        "base-5-nano",
+        "base-4.1",
+        "base-4.1-mini",
+        "base-4.1-nano",
+        "base-5.2",
+        "base-5.2-chat-latest",
+        "gemini-3-pro",
+        "gemini-3-flash",
+        "gemini-2.5-pro",
+        "gemini-2.5-flash",
+        "gemini-2.5-flash-lite",
+    ]
     """The model to use for extraction."""
 
     ocr_enhance: Annotated[OcrEnhance, PropertyInfo(alias="ocrEnhance")]
     """OCR enhancement configuration for figure and text analysis."""
 
+    ocr_quality: Annotated[Literal["high", "low"], PropertyInfo(alias="ocrQuality")]
+    """OCR quality setting"""
+
     priority: Literal["interactive", "non-interactive"]
     """The priority of the extraction task. Non-interactive is lower priority."""
 

{samplehc-0.18.0 → samplehc-0.19.0}/tests/api_resources/v2/test_documents.py

@@ -253,6 +253,7 @@ class TestDocuments:
                 ],
                 "summarize_figures": True,
             },
+            ocr_quality="high",
             priority="interactive",
             reasoning_effort="low",
         )
@@ -866,6 +867,7 @@ class TestAsyncDocuments:
                 ],
                 "summarize_figures": True,
             },
+            ocr_quality="high",
             priority="interactive",
             reasoning_effort="low",
         )

samplehc-0.19.0/tests/test_utils/test_json.py

@@ -0,0 +1,126 @@
+from __future__ import annotations
+
+import datetime
+from typing import Union
+
+import pydantic
+
+from samplehc import _compat
+from samplehc._utils._json import openapi_dumps
+
+
+class TestOpenapiDumps:
+    def test_basic(self) -> None:
+        data = {"key": "value", "number": 42}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"key":"value","number":42}'
+
+    def test_datetime_serialization(self) -> None:
+        dt = datetime.datetime(2023, 1, 1, 12, 0, 0)
+        data = {"datetime": dt}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"datetime":"2023-01-01T12:00:00"}'
+
+    def test_pydantic_model_serialization(self) -> None:
+        class User(pydantic.BaseModel):
+            first_name: str
+            last_name: str
+            age: int
+
+        model_instance = User(first_name="John", last_name="Kramer", age=83)
+        data = {"model": model_instance}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"first_name":"John","last_name":"Kramer","age":83}}'
+
+    def test_pydantic_model_with_default_values(self) -> None:
+        class User(pydantic.BaseModel):
+            name: str
+            role: str = "user"
+            active: bool = True
+            score: int = 0
+
+        model_instance = User(name="Alice")
+        data = {"model": model_instance}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"name":"Alice"}}'
+
+    def test_pydantic_model_with_default_values_overridden(self) -> None:
+        class User(pydantic.BaseModel):
+            name: str
+            role: str = "user"
+            active: bool = True
+
+        model_instance = User(name="Bob", role="admin", active=False)
+        data = {"model": model_instance}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"name":"Bob","role":"admin","active":false}}'
+
+    def test_pydantic_model_with_alias(self) -> None:
+        class User(pydantic.BaseModel):
+            first_name: str = pydantic.Field(alias="firstName")
+            last_name: str = pydantic.Field(alias="lastName")
+
+        model_instance = User(firstName="John", lastName="Doe")
+        data = {"model": model_instance}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"firstName":"John","lastName":"Doe"}}'
+
+    def test_pydantic_model_with_alias_and_default(self) -> None:
+        class User(pydantic.BaseModel):
+            user_name: str = pydantic.Field(alias="userName")
+            user_role: str = pydantic.Field(default="member", alias="userRole")
+            is_active: bool = pydantic.Field(default=True, alias="isActive")
+
+        model_instance = User(userName="charlie")
+        data = {"model": model_instance}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"userName":"charlie"}}'
+
+        model_with_overrides = User(userName="diana", userRole="admin", isActive=False)
+        data = {"model": model_with_overrides}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"userName":"diana","userRole":"admin","isActive":false}}'
+
+    def test_pydantic_model_with_nested_models_and_defaults(self) -> None:
+        class Address(pydantic.BaseModel):
+            street: str
+            city: str = "Unknown"
+
+        class User(pydantic.BaseModel):
+            name: str
+            address: Address
+            verified: bool = False
+
+        if _compat.PYDANTIC_V1:
+            # to handle forward references in Pydantic v1
+            User.update_forward_refs(**locals())  # type: ignore[reportDeprecated]
+
+        address = Address(street="123 Main St")
+        user = User(name="Diana", address=address)
+        data = {"user": user}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"user":{"name":"Diana","address":{"street":"123 Main St"}}}'
+
+        address_with_city = Address(street="456 Oak Ave", city="Boston")
+        user_verified = User(name="Eve", address=address_with_city, verified=True)
+        data = {"user": user_verified}
+        json_bytes = openapi_dumps(data)
+        assert (
+            json_bytes == b'{"user":{"name":"Eve","address":{"street":"456 Oak Ave","city":"Boston"},"verified":true}}'
+        )
+
+    def test_pydantic_model_with_optional_fields(self) -> None:
+        class User(pydantic.BaseModel):
+            name: str
+            email: Union[str, None]
+            phone: Union[str, None]
+
+        model_with_none = User(name="Eve", email=None, phone=None)
+        data = {"model": model_with_none}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"name":"Eve","email":null,"phone":null}}'
+
+        model_with_values = User(name="Frank", email="frank@example.com", phone=None)
+        data = {"model": model_with_values}
+        json_bytes = openapi_dumps(data)
+        assert json_bytes == b'{"model":{"name":"Frank","email":"frank@example.com","phone":null}}'

samplehc-0.18.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.18.0"
-}