prelude-python-sdk 0.1.0a5__tar.gz → 0.1.0a7__tar.gz

prelude_python_sdk-0.1.0a7/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-alpha.7"
+}

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog
 
+## 0.1.0-alpha.7 (2025-01-08)
+
+Full Changelog: [v0.1.0-alpha.6...v0.1.0-alpha.7](https://github.com/prelude-so/python-sdk/compare/v0.1.0-alpha.6...v0.1.0-alpha.7)
+
+### Features
+
+* **api:** update via SDK Studio ([#40](https://github.com/prelude-so/python-sdk/issues/40)) ([a16ad08](https://github.com/prelude-so/python-sdk/commit/a16ad08cc54132be9f0d3553b21d98ca983edcba))
+
+
+### Bug Fixes
+
+* **client:** only call .close() when needed ([#37](https://github.com/prelude-so/python-sdk/issues/37)) ([9d64934](https://github.com/prelude-so/python-sdk/commit/9d64934403b4cfa4becd15b3d4f9934354ce1135))
+
+
+### Chores
+
+* add missing isclass check ([#35](https://github.com/prelude-so/python-sdk/issues/35)) ([09b83f5](https://github.com/prelude-so/python-sdk/commit/09b83f50fd71367bee93758a31cd53621ba56ab3))
+* **internal:** add support for TypeAliasType ([#31](https://github.com/prelude-so/python-sdk/issues/31)) ([a734093](https://github.com/prelude-so/python-sdk/commit/a7340937bba33d659b17e001c3dc98d7f4b8d009))
+* **internal:** bump httpx dependency ([#36](https://github.com/prelude-so/python-sdk/issues/36)) ([39a4778](https://github.com/prelude-so/python-sdk/commit/39a4778690edc67b96e4b7a67e8d75b3d184502a))
+* **internal:** bump pyright ([#29](https://github.com/prelude-so/python-sdk/issues/29)) ([d10ba94](https://github.com/prelude-so/python-sdk/commit/d10ba94c17a48a69d6de2551f91d417dfd1a14e2))
+* **internal:** codegen related update ([#32](https://github.com/prelude-so/python-sdk/issues/32)) ([f68da06](https://github.com/prelude-so/python-sdk/commit/f68da06af9e1db5524256ee91adeb46746e2d9ce))
+* **internal:** codegen related update ([#34](https://github.com/prelude-so/python-sdk/issues/34)) ([9ac58c5](https://github.com/prelude-so/python-sdk/commit/9ac58c502a1247208c6bc77d482f87b6389dd1a9))
+* **internal:** codegen related update ([#39](https://github.com/prelude-so/python-sdk/issues/39)) ([655d237](https://github.com/prelude-so/python-sdk/commit/655d237f79cf048671378fdfa340b9c32cc36484))
+* **internal:** fix some typos ([#33](https://github.com/prelude-so/python-sdk/issues/33)) ([f720959](https://github.com/prelude-so/python-sdk/commit/f72095954c5f648759c52261916944c4363f2614))
+
+
+### Documentation
+
+* fix typos ([#38](https://github.com/prelude-so/python-sdk/issues/38)) ([84b1be6](https://github.com/prelude-so/python-sdk/commit/84b1be6c4450fbed3d9436dc48ad22a10ec75e0d))
+
+## 0.1.0-alpha.6 (2024-12-11)
+
+Full Changelog: [v0.1.0-alpha.5...v0.1.0-alpha.6](https://github.com/prelude-so/python-sdk/compare/v0.1.0-alpha.5...v0.1.0-alpha.6)
+
+### Features
+
+* **api:** update via SDK Studio ([#27](https://github.com/prelude-so/python-sdk/issues/27)) ([e34eb1c](https://github.com/prelude-so/python-sdk/commit/e34eb1c2f450d5068cce21d414d3a4a04c3b0766))
+
+
+### Chores
+
+* **internal:** bump pydantic dependency ([#25](https://github.com/prelude-so/python-sdk/issues/25)) ([62168ae](https://github.com/prelude-so/python-sdk/commit/62168aeb00400db101ef33e54b8c3d8446bea8f4))
+* make the `Omit` type public ([#23](https://github.com/prelude-so/python-sdk/issues/23)) ([b8aa425](https://github.com/prelude-so/python-sdk/commit/b8aa425a77c73290a46dba106cb7277e67d1bf0f))
+
+
+### Documentation
+
+* **readme:** fix http client proxies example ([#26](https://github.com/prelude-so/python-sdk/issues/26)) ([66ce358](https://github.com/prelude-so/python-sdk/commit/66ce358d153fef76d64827abe99907badb64d220))
+
 ## 0.1.0-alpha.5 (2024-12-03)
 
 Full Changelog: [v0.1.0-alpha.4...v0.1.0-alpha.5](https://github.com/prelude-so/python-sdk/compare/v0.1.0-alpha.4...v0.1.0-alpha.5)

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2024 Prelude
+   Copyright 2025 Prelude
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/PKG-INFO

@@ -1,11 +1,12 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: prelude-python-sdk
-Version: 0.1.0a5
+Version: 0.1.0a7
 Summary: The official Python library for the Prelude API
 Project-URL: Homepage, https://github.com/prelude-so/python-sdk
 Project-URL: Repository, https://github.com/prelude-so/python-sdk
 Author-email: Prelude <hello@prelude.so>
-License: Apache-2.0
+License-Expression: Apache-2.0
+License-File: LICENSE
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: MacOS
@@ -26,7 +27,7 @@ Requires-Dist: distro<2,>=1.7.0
 Requires-Dist: httpx<1,>=0.23.0
 Requires-Dist: pydantic<3,>=1.9.0
 Requires-Dist: sniffio
-Requires-Dist: typing-extensions<5,>=4.7
+Requires-Dist: typing-extensions<5,>=4.10
 Description-Content-Type: text/markdown
 
 # Prelude Python API library
@@ -147,7 +148,7 @@ except prelude_python_sdk.APIStatusError as e:
     print(e.response)
 ```
 
-Error codes are as followed:
+Error codes are as follows:
 
 | Status Code | Error Type                 |
 | ----------- | -------------------------- |
@@ -298,8 +299,7 @@ If you need to access undocumented endpoints, params, or response properties, th
 #### Undocumented endpoints
 
 To make requests to undocumented endpoints, you can make requests using `client.get`, `client.post`, and other
-http verbs. Options on the client will be respected (such as retries) will be respected when making this
-request.
+http verbs. Options on the client will be respected (such as retries) when making this request.
 
 ```py
 import httpx
@@ -328,18 +328,19 @@ can also get all the extra fields on the Pydantic model as a dict with
 
 You can directly override the [httpx client](https://www.python-httpx.org/api/#client) to customize it for your use case, including:
 
-- Support for proxies
-- Custom transports
+- Support for [proxies](https://www.python-httpx.org/advanced/proxies/)
+- Custom [transports](https://www.python-httpx.org/advanced/transports/)
 - Additional [advanced](https://www.python-httpx.org/advanced/clients/) functionality
 
 ```python
+import httpx
 from prelude_python_sdk import Prelude, DefaultHttpxClient
 
 client = Prelude(
     # Or use the `PRELUDE_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
-        proxies="http://my.test.proxy.example.com",
+        proxy="http://my.test.proxy.example.com",
         transport=httpx.HTTPTransport(local_address="0.0.0.0"),
     ),
 )
@@ -355,12 +356,22 @@ client.with_options(http_client=DefaultHttpxClient(...))
 
 By default the library closes underlying HTTP connections whenever the client is [garbage collected](https://docs.python.org/3/reference/datamodel.html#object.__del__). You can manually close the client using the `.close()` method if desired, or with a context manager that closes when exiting.
 
+```py
+from prelude_python_sdk import Prelude
+
+with Prelude() as client:
+  # make requests here
+  ...
+
+# HTTP client is now closed
+```
+
 ## Versioning
 
 This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions, though certain backwards-incompatible changes may be released as minor versions:
 
 1. Changes that only affect static types, without breaking runtime behavior.
-2. Changes to library internals which are technically public but not intended or documented for external use. _(Please open a GitHub issue to let us know if you are relying on such internals)_.
+2. Changes to library internals which are technically public but not intended or documented for external use. _(Please open a GitHub issue to let us know if you are relying on such internals.)_
 3. Changes that we do not expect to impact the vast majority of users in practice.
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/README.md

@@ -116,7 +116,7 @@ except prelude_python_sdk.APIStatusError as e:
     print(e.response)
 ```
 
-Error codes are as followed:
+Error codes are as follows:
 
 | Status Code | Error Type                 |
 | ----------- | -------------------------- |
@@ -267,8 +267,7 @@ If you need to access undocumented endpoints, params, or response properties, th
 #### Undocumented endpoints
 
 To make requests to undocumented endpoints, you can make requests using `client.get`, `client.post`, and other
-http verbs. Options on the client will be respected (such as retries) will be respected when making this
-request.
+http verbs. Options on the client will be respected (such as retries) when making this request.
 
 ```py
 import httpx
@@ -297,18 +296,19 @@ can also get all the extra fields on the Pydantic model as a dict with
 
 You can directly override the [httpx client](https://www.python-httpx.org/api/#client) to customize it for your use case, including:
 
-- Support for proxies
-- Custom transports
+- Support for [proxies](https://www.python-httpx.org/advanced/proxies/)
+- Custom [transports](https://www.python-httpx.org/advanced/transports/)
 - Additional [advanced](https://www.python-httpx.org/advanced/clients/) functionality
 
 ```python
+import httpx
 from prelude_python_sdk import Prelude, DefaultHttpxClient
 
 client = Prelude(
     # Or use the `PRELUDE_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
-        proxies="http://my.test.proxy.example.com",
+        proxy="http://my.test.proxy.example.com",
         transport=httpx.HTTPTransport(local_address="0.0.0.0"),
     ),
 )
@@ -324,12 +324,22 @@ client.with_options(http_client=DefaultHttpxClient(...))
 
 By default the library closes underlying HTTP connections whenever the client is [garbage collected](https://docs.python.org/3/reference/datamodel.html#object.__del__). You can manually close the client using the `.close()` method if desired, or with a context manager that closes when exiting.
 
+```py
+from prelude_python_sdk import Prelude
+
+with Prelude() as client:
+  # make requests here
+  ...
+
+# HTTP client is now closed
+```
+
 ## Versioning
 
 This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) conventions, though certain backwards-incompatible changes may be released as minor versions:
 
 1. Changes that only affect static types, without breaking runtime behavior.
-2. Changes to library internals which are technically public but not intended or documented for external use. _(Please open a GitHub issue to let us know if you are relying on such internals)_.
+2. Changes to library internals which are technically public but not intended or documented for external use. _(Please open a GitHub issue to let us know if you are relying on such internals.)_
 3. Changes that we do not expect to impact the vast majority of users in practice.
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "prelude-python-sdk"
-version = "0.1.0-alpha.5"
+version = "0.1.0-alpha.7"
 description = "The official Python library for the Prelude API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -10,7 +10,7 @@ authors = [
 dependencies = [
     "httpx>=0.23.0, <1",
     "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.7, <5",
+    "typing-extensions>=4.10, <5",
     "anyio>=3.5.0, <5",
     "distro>=1.7.0, <2",
     "sniffio",
@@ -54,7 +54,7 @@ dev-dependencies = [
     "dirty-equals>=0.6.0",
     "importlib-metadata>=6.7.0",
     "rich>=13.7.1",
-    "nest_asyncio==1.6.0"
+    "nest_asyncio==1.6.0",
 ]
 
 [tool.rye.scripts]

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/requirements-dev.lock

@@ -35,7 +35,7 @@ h11==0.14.0
     # via httpcore
 httpcore==1.0.2
     # via httpx
-httpx==0.25.2
+httpx==0.28.1
     # via prelude-python-sdk
     # via respx
 idna==3.4
@@ -62,13 +62,13 @@ platformdirs==3.11.0
     # via virtualenv
 pluggy==1.5.0
     # via pytest
-pydantic==2.9.2
+pydantic==2.10.3
     # via prelude-python-sdk
-pydantic-core==2.23.4
+pydantic-core==2.27.1
     # via pydantic
 pygments==2.18.0
     # via rich
-pyright==1.1.389
+pyright==1.1.390
 pytest==8.3.3
     # via pytest-asyncio
 pytest-asyncio==0.24.0
@@ -76,7 +76,7 @@ python-dateutil==2.8.2
     # via time-machine
 pytz==2023.3.post1
     # via dirty-equals
-respx==0.20.2
+respx==0.22.0
 rich==13.7.1
 ruff==0.6.9
 setuptools==68.2.2
@@ -85,7 +85,6 @@ six==1.16.0
     # via python-dateutil
 sniffio==1.3.0
     # via anyio
-    # via httpx
     # via prelude-python-sdk
 time-machine==2.9.0
 tomli==2.0.2

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/requirements.lock

@@ -25,18 +25,17 @@ h11==0.14.0
     # via httpcore
 httpcore==1.0.2
     # via httpx
-httpx==0.25.2
+httpx==0.28.1
     # via prelude-python-sdk
 idna==3.4
     # via anyio
     # via httpx
-pydantic==2.9.2
+pydantic==2.10.3
     # via prelude-python-sdk
-pydantic-core==2.23.4
+pydantic-core==2.27.1
     # via pydantic
 sniffio==1.3.0
     # via anyio
-    # via httpx
     # via prelude-python-sdk
 typing-extensions==4.12.2
     # via anyio

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/__init__.py

@@ -1,7 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 from . import types
-from ._types import NOT_GIVEN, NoneType, NotGiven, Transport, ProxiesTypes
+from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
 from ._utils import file_from_path
 from ._client import Client, Stream, Prelude, Timeout, Transport, AsyncClient, AsyncStream, AsyncPrelude, RequestOptions
 from ._models import BaseModel
@@ -36,6 +36,7 @@ __all__ = [
     "ProxiesTypes",
     "NotGiven",
     "NOT_GIVEN",
+    "Omit",
     "PreludeError",
     "APIError",
     "APIStatusError",

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_base_client.py

@@ -767,6 +767,9 @@ else:
 
 class SyncHttpxClientWrapper(DefaultHttpxClient):
     def __del__(self) -> None:
+        if self.is_closed:
+            return
+
         try:
             self.close()
         except Exception:
@@ -1334,6 +1337,9 @@ else:
 
 class AsyncHttpxClientWrapper(DefaultAsyncHttpxClient):
     def __del__(self) -> None:
+        if self.is_closed:
+            return
+
         try:
             # TODO(someday): support non asyncio runtimes here
             asyncio.get_running_loop().create_task(self.aclose())

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_client.py

@@ -8,7 +8,7 @@ from typing_extensions import Self, override
 
 import httpx
 
-from . import resources, _exceptions
+from . import _exceptions
 from ._qs import Querystring
 from ._types import (
     NOT_GIVEN,
@@ -24,6 +24,7 @@ from ._utils import (
     get_async_library,
 )
 from ._version import __version__
+from .resources import watch, verification, transactional
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import PreludeError, APIStatusError
 from ._base_client import (
@@ -32,23 +33,13 @@ from ._base_client import (
     AsyncAPIClient,
 )
 
-__all__ = [
-    "Timeout",
-    "Transport",
-    "ProxiesTypes",
-    "RequestOptions",
-    "resources",
-    "Prelude",
-    "AsyncPrelude",
-    "Client",
-    "AsyncClient",
-]
+__all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Prelude", "AsyncPrelude", "Client", "AsyncClient"]
 
 
 class Prelude(SyncAPIClient):
-    transactional: resources.TransactionalResource
-    verification: resources.VerificationResource
-    watch: resources.WatchResource
+    transactional: transactional.TransactionalResource
+    verification: verification.VerificationResource
+    watch: watch.WatchResource
     with_raw_response: PreludeWithRawResponse
     with_streaming_response: PreludeWithStreamedResponse
 
@@ -106,9 +97,9 @@ class Prelude(SyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
-        self.transactional = resources.TransactionalResource(self)
-        self.verification = resources.VerificationResource(self)
-        self.watch = resources.WatchResource(self)
+        self.transactional = transactional.TransactionalResource(self)
+        self.verification = verification.VerificationResource(self)
+        self.watch = watch.WatchResource(self)
         self.with_raw_response = PreludeWithRawResponse(self)
         self.with_streaming_response = PreludeWithStreamedResponse(self)
 
@@ -218,9 +209,9 @@ class Prelude(SyncAPIClient):
 
 
 class AsyncPrelude(AsyncAPIClient):
-    transactional: resources.AsyncTransactionalResource
-    verification: resources.AsyncVerificationResource
-    watch: resources.AsyncWatchResource
+    transactional: transactional.AsyncTransactionalResource
+    verification: verification.AsyncVerificationResource
+    watch: watch.AsyncWatchResource
     with_raw_response: AsyncPreludeWithRawResponse
     with_streaming_response: AsyncPreludeWithStreamedResponse
 
@@ -278,9 +269,9 @@ class AsyncPrelude(AsyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
-        self.transactional = resources.AsyncTransactionalResource(self)
-        self.verification = resources.AsyncVerificationResource(self)
-        self.watch = resources.AsyncWatchResource(self)
+        self.transactional = transactional.AsyncTransactionalResource(self)
+        self.verification = verification.AsyncVerificationResource(self)
+        self.watch = watch.AsyncWatchResource(self)
         self.with_raw_response = AsyncPreludeWithRawResponse(self)
         self.with_streaming_response = AsyncPreludeWithStreamedResponse(self)
 
@@ -391,30 +382,30 @@ class AsyncPrelude(AsyncAPIClient):
 
 class PreludeWithRawResponse:
     def __init__(self, client: Prelude) -> None:
-        self.transactional = resources.TransactionalResourceWithRawResponse(client.transactional)
-        self.verification = resources.VerificationResourceWithRawResponse(client.verification)
-        self.watch = resources.WatchResourceWithRawResponse(client.watch)
+        self.transactional = transactional.TransactionalResourceWithRawResponse(client.transactional)
+        self.verification = verification.VerificationResourceWithRawResponse(client.verification)
+        self.watch = watch.WatchResourceWithRawResponse(client.watch)
 
 
 class AsyncPreludeWithRawResponse:
     def __init__(self, client: AsyncPrelude) -> None:
-        self.transactional = resources.AsyncTransactionalResourceWithRawResponse(client.transactional)
-        self.verification = resources.AsyncVerificationResourceWithRawResponse(client.verification)
-        self.watch = resources.AsyncWatchResourceWithRawResponse(client.watch)
+        self.transactional = transactional.AsyncTransactionalResourceWithRawResponse(client.transactional)
+        self.verification = verification.AsyncVerificationResourceWithRawResponse(client.verification)
+        self.watch = watch.AsyncWatchResourceWithRawResponse(client.watch)
 
 
 class PreludeWithStreamedResponse:
     def __init__(self, client: Prelude) -> None:
-        self.transactional = resources.TransactionalResourceWithStreamingResponse(client.transactional)
-        self.verification = resources.VerificationResourceWithStreamingResponse(client.verification)
-        self.watch = resources.WatchResourceWithStreamingResponse(client.watch)
+        self.transactional = transactional.TransactionalResourceWithStreamingResponse(client.transactional)
+        self.verification = verification.VerificationResourceWithStreamingResponse(client.verification)
+        self.watch = watch.WatchResourceWithStreamingResponse(client.watch)
 
 
 class AsyncPreludeWithStreamedResponse:
     def __init__(self, client: AsyncPrelude) -> None:
-        self.transactional = resources.AsyncTransactionalResourceWithStreamingResponse(client.transactional)
-        self.verification = resources.AsyncVerificationResourceWithStreamingResponse(client.verification)
-        self.watch = resources.AsyncWatchResourceWithStreamingResponse(client.watch)
+        self.transactional = transactional.AsyncTransactionalResourceWithStreamingResponse(client.transactional)
+        self.verification = verification.AsyncVerificationResourceWithStreamingResponse(client.verification)
+        self.watch = watch.AsyncWatchResourceWithStreamingResponse(client.watch)
 
 
 Client = Prelude

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_models.py

@@ -46,6 +46,7 @@ from ._utils import (
     strip_not_given,
     extract_type_arg,
     is_annotated_type,
+    is_type_alias_type,
     strip_annotated_type,
 )
 from ._compat import (
@@ -428,6 +429,8 @@ def construct_type(*, value: object, type_: object) -> object:
     # we allow `object` as the input type because otherwise, passing things like
     # `Literal['value']` will be reported as a type error by type checkers
     type_ = cast("type[object]", type_)
+    if is_type_alias_type(type_):
+        type_ = type_.__value__  # type: ignore[unreachable]
 
     # unwrap `Annotated[T, ...]` -> `T`
     if is_annotated_type(type_):
@@ -485,7 +488,11 @@ def construct_type(*, value: object, type_: object) -> object:
         _, items_type = get_args(type_)  # Dict[_, items_type]
         return {key: construct_type(value=item, type_=items_type) for key, item in value.items()}
 
-    if not is_literal_type(type_) and (issubclass(origin, BaseModel) or issubclass(origin, GenericModel)):
+    if (
+        not is_literal_type(type_)
+        and inspect.isclass(origin)
+        and (issubclass(origin, BaseModel) or issubclass(origin, GenericModel))
+    ):
         if is_list(value):
             return [cast(Any, type_).construct(**entry) if is_mapping(entry) else entry for entry in value]
 

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_response.py

@@ -25,7 +25,7 @@ import httpx
 import pydantic
 
 from ._types import NoneType
-from ._utils import is_given, extract_type_arg, is_annotated_type, extract_type_var_from_base
+from ._utils import is_given, extract_type_arg, is_annotated_type, is_type_alias_type, extract_type_var_from_base
 from ._models import BaseModel, is_basemodel
 from ._constants import RAW_RESPONSE_HEADER, OVERRIDE_CAST_TO_HEADER
 from ._streaming import Stream, AsyncStream, is_stream_class_type, extract_stream_chunk_type
@@ -126,9 +126,15 @@ class BaseAPIResponse(Generic[R]):
         )
 
     def _parse(self, *, to: type[_T] | None = None) -> R | _T:
+        cast_to = to if to is not None else self._cast_to
+
+        # unwrap `TypeAlias('Name', T)` -> `T`
+        if is_type_alias_type(cast_to):
+            cast_to = cast_to.__value__  # type: ignore[unreachable]
+
         # unwrap `Annotated[T, ...]` -> `T`
-        if to and is_annotated_type(to):
-            to = extract_type_arg(to, 0)
+        if cast_to and is_annotated_type(cast_to):
+            cast_to = extract_type_arg(cast_to, 0)
 
         if self._is_sse_stream:
             if to:
@@ -164,18 +170,12 @@ class BaseAPIResponse(Generic[R]):
             return cast(
                 R,
                 stream_cls(
-                    cast_to=self._cast_to,
+                    cast_to=cast_to,
                     response=self.http_response,
                     client=cast(Any, self._client),
                 ),
             )
 
-        cast_to = to if to is not None else self._cast_to
-
-        # unwrap `Annotated[T, ...]` -> `T`
-        if is_annotated_type(cast_to):
-            cast_to = extract_type_arg(cast_to, 0)
-
         if cast_to is NoneType:
             return cast(R, None)
 

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_types.py

@@ -192,10 +192,8 @@ ResponseT = TypeVar(
 StrBytesIntFloat = Union[str, bytes, int, float]
 
 # Note: copied from Pydantic
-# https://github.com/pydantic/pydantic/blob/32ea570bf96e84234d2992e1ddf40ab8a565925a/pydantic/main.py#L49
-IncEx: TypeAlias = Union[
-    Set[int], Set[str], Mapping[int, Union["IncEx", Literal[True]]], Mapping[str, Union["IncEx", Literal[True]]]
-]
+# https://github.com/pydantic/pydantic/blob/6f31f8f68ef011f84357330186f603ff295312fd/pydantic/main.py#L79
+IncEx: TypeAlias = Union[Set[int], Set[str], Mapping[int, Union["IncEx", bool]], Mapping[str, Union["IncEx", bool]]]
 
 PostParser = Callable[[Any], Any]
 

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_utils/__init__.py

@@ -39,6 +39,7 @@ from ._typing import (
     is_iterable_type as is_iterable_type,
     is_required_type as is_required_type,
     is_annotated_type as is_annotated_type,
+    is_type_alias_type as is_type_alias_type,
     strip_annotated_type as strip_annotated_type,
     extract_type_var_from_base as extract_type_var_from_base,
 )

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_utils/_typing.py

@@ -1,8 +1,17 @@
 from __future__ import annotations
 
+import sys
+import typing
+import typing_extensions
 from typing import Any, TypeVar, Iterable, cast
 from collections import abc as _c_abc
-from typing_extensions import Required, Annotated, get_args, get_origin
+from typing_extensions import (
+    TypeIs,
+    Required,
+    Annotated,
+    get_args,
+    get_origin,
+)
 
 from .._types import InheritsGeneric
 from .._compat import is_union as _is_union
@@ -36,6 +45,26 @@ def is_typevar(typ: type) -> bool:
     return type(typ) == TypeVar  # type: ignore
 
 
+_TYPE_ALIAS_TYPES: tuple[type[typing_extensions.TypeAliasType], ...] = (typing_extensions.TypeAliasType,)
+if sys.version_info >= (3, 12):
+    _TYPE_ALIAS_TYPES = (*_TYPE_ALIAS_TYPES, typing.TypeAliasType)
+
+
+def is_type_alias_type(tp: Any, /) -> TypeIs[typing_extensions.TypeAliasType]:
+    """Return whether the provided argument is an instance of `TypeAliasType`.
+
+    ```python
+    type Int = int
+    is_type_alias_type(Int)
+    # > True
+    Str = TypeAliasType("Str", str)
+    is_type_alias_type(Str)
+    # > True
+    ```
+    """
+    return isinstance(tp, _TYPE_ALIAS_TYPES)
+
+
 # Extracts T from Annotated[T, ...] or from Required[Annotated[T, ...]]
 def strip_annotated_type(typ: type) -> type:
     if is_required_type(typ) or is_annotated_type(typ):

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "prelude_python_sdk"
-__version__ = "0.1.0-alpha.5"  # x-release-please-version
+__version__ = "0.1.0-alpha.7"  # x-release-please-version

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/src/prelude_python_sdk/types/verification_create_params.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 
 from typing_extensions import Literal, Required, TypedDict
 
-__all__ = ["VerificationCreateParams", "Target", "Metadata", "Options", "Signals"]
+__all__ = ["VerificationCreateParams", "Target", "Metadata", "Options", "OptionsAppRealm", "Signals"]
 
 
 class VerificationCreateParams(TypedDict, total=False):
@@ -38,12 +38,29 @@ class Metadata(TypedDict, total=False):
     """A user-defined identifier to correlate this verification with."""
 
 
+class OptionsAppRealm(TypedDict, total=False):
+    platform: Required[Literal["android"]]
+    """The platform the SMS will be sent to.
+
+    We are currently only supporting "android".
+    """
+
+    value: Required[str]
+    """The Android SMS Retriever API hash code that identifies your app."""
+
+
 class Options(TypedDict, total=False):
-    app_realm: str
-    """The Android SMS Retriever API hash code that identifies your app.
+    app_realm: OptionsAppRealm
+    """This allows you to automatically retrieve and fill the OTP code on mobile apps.
+
+    Currently only Android devices are supported.
+    """
+
+    code_size: int
+    """The size of the code generated.
 
-    This allows you to automatically retrieve and fill the OTP code on Android
-    devices.
+    It should be between 4 and 8. Defaults to the code size specified from the
+    Dashboard.
     """
 
     custom_code: str
@@ -95,7 +112,7 @@ class Signals(TypedDict, total=False):
     ip: str
     """The IP address of the user's device."""
 
-    is_trusted_user: str
+    is_trusted_user: bool
     """
     This signal should provide a higher level of trust, indicating that the user is
     genuine. For more details, refer to [Signals](/guides/prevent-fraud#signals).

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/tests/api_resources/test_verification.py

@@ -39,7 +39,11 @@ class TestVerification:
             },
             metadata={"correlation_id": "correlation_id"},
             options={
-                "app_realm": "app_realm",
+                "app_realm": {
+                    "platform": "android",
+                    "value": "value",
+                },
+                "code_size": 5,
                 "custom_code": "custom_code",
                 "locale": "el-GR",
                 "sender_id": "sender_id",
@@ -51,7 +55,7 @@ class TestVerification:
                 "device_model": "iPhone17,2",
                 "device_platform": "android",
                 "ip": "192.0.2.1",
-                "is_trusted_user": "is_trusted_user",
+                "is_trusted_user": False,
                 "os_version": "18.0.1",
             },
         )
@@ -153,7 +157,11 @@ class TestAsyncVerification:
             },
             metadata={"correlation_id": "correlation_id"},
             options={
-                "app_realm": "app_realm",
+                "app_realm": {
+                    "platform": "android",
+                    "value": "value",
+                },
+                "code_size": 5,
                 "custom_code": "custom_code",
                 "locale": "el-GR",
                 "sender_id": "sender_id",
@@ -165,7 +173,7 @@ class TestAsyncVerification:
                 "device_model": "iPhone17,2",
                 "device_platform": "android",
                 "ip": "192.0.2.1",
-                "is_trusted_user": "is_trusted_user",
+                "is_trusted_user": False,
                 "os_version": "18.0.1",
             },
         )

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/tests/test_client.py

@@ -358,11 +358,11 @@ class TestPrelude:
             FinalRequestOptions(
                 method="get",
                 url="/foo",
-                params={"foo": "baz", "query_param": "overriden"},
+                params={"foo": "baz", "query_param": "overridden"},
             )
         )
         url = httpx.URL(request.url)
-        assert dict(url.params) == {"foo": "baz", "query_param": "overriden"}
+        assert dict(url.params) == {"foo": "baz", "query_param": "overridden"}
 
     def test_request_extra_json(self) -> None:
         request = self.client._build_request(
@@ -1166,11 +1166,11 @@ class TestAsyncPrelude:
             FinalRequestOptions(
                 method="get",
                 url="/foo",
-                params={"foo": "baz", "query_param": "overriden"},
+                params={"foo": "baz", "query_param": "overridden"},
             )
         )
         url = httpx.URL(request.url)
-        assert dict(url.params) == {"foo": "baz", "query_param": "overriden"}
+        assert dict(url.params) == {"foo": "baz", "query_param": "overridden"}
 
     def test_request_extra_json(self) -> None:
         request = self.client._build_request(

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/tests/test_models.py

@@ -1,7 +1,7 @@
 import json
 from typing import Any, Dict, List, Union, Optional, cast
 from datetime import datetime, timezone
-from typing_extensions import Literal, Annotated
+from typing_extensions import Literal, Annotated, TypeAliasType
 
 import pytest
 import pydantic
@@ -828,3 +828,19 @@ def test_discriminated_unions_invalid_data_uses_cache() -> None:
     # if the discriminator details object stays the same between invocations then
     # we hit the cache
     assert UnionType.__discriminator__ is discriminator
+
+
+@pytest.mark.skipif(not PYDANTIC_V2, reason="TypeAliasType is not supported in Pydantic v1")
+def test_type_alias_type() -> None:
+    Alias = TypeAliasType("Alias", str)
+
+    class Model(BaseModel):
+        alias: Alias
+        union: Union[int, Alias]
+
+    m = construct_type(value={"alias": "foo", "union": "bar"}, type_=Model)
+    assert isinstance(m, Model)
+    assert isinstance(m.alias, str)
+    assert m.alias == "foo"
+    assert isinstance(m.union, str)
+    assert m.union == "bar"

{prelude_python_sdk-0.1.0a5 → prelude_python_sdk-0.1.0a7}/tests/utils.py

@@ -16,6 +16,7 @@ from prelude_python_sdk._utils import (
     is_union_type,
     extract_type_arg,
     is_annotated_type,
+    is_type_alias_type,
 )
 from prelude_python_sdk._compat import PYDANTIC_V2, field_outer_type, get_model_fields
 from prelude_python_sdk._models import BaseModel
@@ -51,6 +52,9 @@ def assert_matches_type(
     path: list[str],
     allow_none: bool = False,
 ) -> None:
+    if is_type_alias_type(type_):
+        type_ = type_.__value__
+
     # unwrap `Annotated[T, ...]` -> `T`
     if is_annotated_type(type_):
         type_ = extract_type_arg(type_, 0)

prelude_python_sdk-0.1.0a5/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.1.0-alpha.5"
-}