prelude-python-sdk 0.9.0__tar.gz → 0.10.0__tar.gz

prelude_python_sdk-0.10.0/.release-please-manifest.json

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

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.10.0 (2025-12-05)
+
+Full Changelog: [v0.9.0...v0.10.0](https://github.com/prelude-so/python-sdk/compare/v0.9.0...v0.10.0)
+
+### Features
+
+* **api:** add Notify API methods ([c7a7b20](https://github.com/prelude-so/python-sdk/commit/c7a7b20977b74d76362e4aad805be06b7618f652))
+
+
+### Bug Fixes
+
+* ensure streams are always closed ([b16816e](https://github.com/prelude-so/python-sdk/commit/b16816e137cdbe2814625782094d929f0c98705c))
+
+
+### Chores
+
+* **deps:** mypy 1.18.1 has a regression, pin to 1.17 ([e2e5272](https://github.com/prelude-so/python-sdk/commit/e2e5272322db24cc9faa0b7176cefcc81e3daf48))
+* **docs:** use environment variables for authentication in code snippets ([1d08cda](https://github.com/prelude-so/python-sdk/commit/1d08cda0dfca3a9e0adb3f548f6a4275bfc44efa))
+* **internal:** codegen related update ([469e780](https://github.com/prelude-so/python-sdk/commit/469e7805bc68624a0768e1403c1fc637b256a698))
+* update lockfile ([2ff2aee](https://github.com/prelude-so/python-sdk/commit/2ff2aee46c7b89093cdcd43dd293e9dc6f101ada))
+
 ## 0.9.0 (2025-11-17)
 
 Full Changelog: [v0.8.0...v0.9.0](https://github.com/prelude-so/python-sdk/compare/v0.8.0...v0.9.0)

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: prelude-python-sdk
-Version: 0.9.0
+Version: 0.10.0
 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
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.9
@@ -123,6 +124,7 @@ pip install prelude-python-sdk[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from prelude_python_sdk import DefaultAioHttpClient
 from prelude_python_sdk import AsyncPrelude
@@ -130,7 +132,7 @@ from prelude_python_sdk import AsyncPrelude
 
 async def main() -> None:
     async with AsyncPrelude(
-        api_token="My API Token",
+        api_token=os.environ.get("API_TOKEN"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         verification = await client.verification.create(

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/README.md

@@ -89,6 +89,7 @@ pip install prelude-python-sdk[aiohttp]
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from prelude_python_sdk import DefaultAioHttpClient
 from prelude_python_sdk import AsyncPrelude
@@ -96,7 +97,7 @@ from prelude_python_sdk import AsyncPrelude
 
 async def main() -> None:
     async with AsyncPrelude(
-        api_token="My API Token",
+        api_token=os.environ.get("API_TOKEN"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         verification = await client.verification.create(

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/api.md

@@ -10,6 +10,32 @@ Methods:
 
 - <code title="get /v2/lookup/{phone_number}">client.lookup.<a href="./src/prelude_python_sdk/resources/lookup.py">lookup</a>(phone_number, \*\*<a href="src/prelude_python_sdk/types/lookup_lookup_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/lookup_lookup_response.py">LookupLookupResponse</a></code>
 
+# Notify
+
+Types:
+
+```python
+from prelude_python_sdk.types import (
+    NotifyGetSubscriptionConfigResponse,
+    NotifyGetSubscriptionPhoneNumberResponse,
+    NotifyListSubscriptionConfigsResponse,
+    NotifyListSubscriptionPhoneNumberEventsResponse,
+    NotifyListSubscriptionPhoneNumbersResponse,
+    NotifySendResponse,
+    NotifySendBatchResponse,
+)
+```
+
+Methods:
+
+- <code title="get /v2/notify/management/subscriptions/{config_id}">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">get_subscription_config</a>(config_id) -> <a href="./src/prelude_python_sdk/types/notify_get_subscription_config_response.py">NotifyGetSubscriptionConfigResponse</a></code>
+- <code title="get /v2/notify/management/subscriptions/{config_id}/phone_numbers/{phone_number}">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">get_subscription_phone_number</a>(phone_number, \*, config_id) -> <a href="./src/prelude_python_sdk/types/notify_get_subscription_phone_number_response.py">NotifyGetSubscriptionPhoneNumberResponse</a></code>
+- <code title="get /v2/notify/management/subscriptions">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">list_subscription_configs</a>(\*\*<a href="src/prelude_python_sdk/types/notify_list_subscription_configs_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/notify_list_subscription_configs_response.py">NotifyListSubscriptionConfigsResponse</a></code>
+- <code title="get /v2/notify/management/subscriptions/{config_id}/phone_numbers/{phone_number}/events">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">list_subscription_phone_number_events</a>(phone_number, \*, config_id, \*\*<a href="src/prelude_python_sdk/types/notify_list_subscription_phone_number_events_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/notify_list_subscription_phone_number_events_response.py">NotifyListSubscriptionPhoneNumberEventsResponse</a></code>
+- <code title="get /v2/notify/management/subscriptions/{config_id}/phone_numbers">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">list_subscription_phone_numbers</a>(config_id, \*\*<a href="src/prelude_python_sdk/types/notify_list_subscription_phone_numbers_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/notify_list_subscription_phone_numbers_response.py">NotifyListSubscriptionPhoneNumbersResponse</a></code>
+- <code title="post /v2/notify">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">send</a>(\*\*<a href="src/prelude_python_sdk/types/notify_send_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/notify_send_response.py">NotifySendResponse</a></code>
+- <code title="post /v2/notify/batch">client.notify.<a href="./src/prelude_python_sdk/resources/notify.py">send_batch</a>(\*\*<a href="src/prelude_python_sdk/types/notify_send_batch_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/notify_send_batch_response.py">NotifySendBatchResponse</a></code>
+
 # Transactional
 
 Types:

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/pyproject.toml

@@ -1,20 +1,22 @@
 [project]
 name = "prelude-python-sdk"
-version = "0.9.0"
+version = "0.10.0"
 description = "The official Python library for the Prelude API"
 dynamic = ["readme"]
 license = "Apache-2.0"
 authors = [
 { name = "Prelude", email = "hello@prelude.so" },
 ]
+
 dependencies = [
-    "httpx>=0.23.0, <1",
-    "pydantic>=1.9.0, <3",
-    "typing-extensions>=4.10, <5",
-    "anyio>=3.5.0, <5",
-    "distro>=1.7.0, <2",
-    "sniffio",
+  "httpx>=0.23.0, <1",
+  "pydantic>=1.9.0, <3",
+  "typing-extensions>=4.10, <5",
+  "anyio>=3.5.0, <5",
+  "distro>=1.7.0, <2",
+  "sniffio",
 ]
+
 requires-python = ">= 3.9"
 classifiers = [
   "Typing :: Typed",
@@ -24,6 +26,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Operating System :: OS Independent",
   "Operating System :: POSIX",
   "Operating System :: MacOS",
@@ -45,7 +48,7 @@ managed = true
 # version pins are in requirements-dev.lock
 dev-dependencies = [
     "pyright==1.1.399",
-    "mypy",
+    "mypy==1.17",
     "respx",
     "pytest",
     "pytest-asyncio",

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/requirements-dev.lock

@@ -12,40 +12,45 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via httpx-aiohttp
     # via prelude-python-sdk
-aiosignal==1.3.2
+aiosignal==1.4.0
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
-anyio==4.4.0
+anyio==4.12.0
     # via httpx
     # via prelude-python-sdk
-argcomplete==3.1.2
+argcomplete==3.6.3
     # via nox
 async-timeout==5.0.1
     # via aiohttp
-attrs==25.3.0
+attrs==25.4.0
     # via aiohttp
-certifi==2023.7.22
+    # via nox
+backports-asyncio-runner==1.2.0
+    # via pytest-asyncio
+certifi==2025.11.12
     # via httpcore
     # via httpx
-colorlog==6.7.0
+colorlog==6.10.1
+    # via nox
+dependency-groups==1.3.1
     # via nox
-dirty-equals==0.6.0
-distlib==0.3.7
+dirty-equals==0.11
+distlib==0.4.0
     # via virtualenv
-distro==1.8.0
+distro==1.9.0
     # via prelude-python-sdk
-exceptiongroup==1.2.2
+exceptiongroup==1.3.1
     # via anyio
     # via pytest
-execnet==2.1.1
+execnet==2.1.2
     # via pytest-xdist
-filelock==3.12.4
+filelock==3.19.1
     # via virtualenv
-frozenlist==1.6.2
+frozenlist==1.8.0
     # via aiohttp
     # via aiosignal
 h11==0.16.0
@@ -58,80 +63,87 @@ httpx==0.28.1
     # via respx
 httpx-aiohttp==0.1.9
     # via prelude-python-sdk
-idna==3.4
+humanize==4.13.0
+    # via nox
+idna==3.11
     # via anyio
     # via httpx
     # via yarl
-importlib-metadata==7.0.0
-iniconfig==2.0.0
+importlib-metadata==8.7.0
+iniconfig==2.1.0
     # via pytest
 markdown-it-py==3.0.0
     # via rich
 mdurl==0.1.2
     # via markdown-it-py
-multidict==6.4.4
+multidict==6.7.0
     # via aiohttp
     # via yarl
-mypy==1.14.1
-mypy-extensions==1.0.0
+mypy==1.17.0
+mypy-extensions==1.1.0
     # via mypy
-nodeenv==1.8.0
+nodeenv==1.9.1
     # via pyright
-nox==2023.4.22
-packaging==23.2
+nox==2025.11.12
+packaging==25.0
+    # via dependency-groups
     # via nox
     # via pytest
-platformdirs==3.11.0
+pathspec==0.12.1
+    # via mypy
+platformdirs==4.4.0
     # via virtualenv
-pluggy==1.5.0
+pluggy==1.6.0
     # via pytest
-propcache==0.3.1
+propcache==0.4.1
     # via aiohttp
     # via yarl
-pydantic==2.11.9
+pydantic==2.12.5
     # via prelude-python-sdk
-pydantic-core==2.33.2
+pydantic-core==2.41.5
     # via pydantic
-pygments==2.18.0
+pygments==2.19.2
+    # via pytest
     # via rich
 pyright==1.1.399
-pytest==8.3.3
+pytest==8.4.2
     # via pytest-asyncio
     # via pytest-xdist
-pytest-asyncio==0.24.0
-pytest-xdist==3.7.0
-python-dateutil==2.8.2
+pytest-asyncio==1.2.0
+pytest-xdist==3.8.0
+python-dateutil==2.9.0.post0
     # via time-machine
-pytz==2023.3.post1
-    # via dirty-equals
 respx==0.22.0
-rich==13.7.1
-ruff==0.9.4
-setuptools==68.2.2
-    # via nodeenv
-six==1.16.0
+rich==14.2.0
+ruff==0.14.7
+six==1.17.0
     # via python-dateutil
-sniffio==1.3.0
-    # via anyio
+sniffio==1.3.1
     # via prelude-python-sdk
-time-machine==2.9.0
-tomli==2.0.2
+time-machine==2.19.0
+tomli==2.3.0
+    # via dependency-groups
     # via mypy
+    # via nox
     # via pytest
-typing-extensions==4.12.2
+typing-extensions==4.15.0
+    # via aiosignal
     # via anyio
+    # via exceptiongroup
     # via multidict
     # via mypy
     # via prelude-python-sdk
     # via pydantic
     # via pydantic-core
     # via pyright
+    # via pytest-asyncio
     # via typing-inspection
-typing-inspection==0.4.1
+    # via virtualenv
+typing-inspection==0.4.2
     # via pydantic
-virtualenv==20.24.5
+virtualenv==20.35.4
     # via nox
-yarl==1.20.0
+yarl==1.22.0
     # via aiohttp
-zipp==3.17.0
+zipp==3.23.0
     # via importlib-metadata

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/requirements.lock

@@ -12,28 +12,28 @@
 -e file:.
 aiohappyeyeballs==2.6.1
     # via aiohttp
-aiohttp==3.12.8
+aiohttp==3.13.2
     # via httpx-aiohttp
     # via prelude-python-sdk
-aiosignal==1.3.2
+aiosignal==1.4.0
     # via aiohttp
-annotated-types==0.6.0
+annotated-types==0.7.0
     # via pydantic
-anyio==4.4.0
+anyio==4.12.0
     # via httpx
     # via prelude-python-sdk
 async-timeout==5.0.1
     # via aiohttp
-attrs==25.3.0
+attrs==25.4.0
     # via aiohttp
-certifi==2023.7.22
+certifi==2025.11.12
     # via httpcore
     # via httpx
-distro==1.8.0
+distro==1.9.0
     # via prelude-python-sdk
-exceptiongroup==1.2.2
+exceptiongroup==1.3.1
     # via anyio
-frozenlist==1.6.2
+frozenlist==1.8.0
     # via aiohttp
     # via aiosignal
 h11==0.16.0
@@ -45,31 +45,32 @@ httpx==0.28.1
     # via prelude-python-sdk
 httpx-aiohttp==0.1.9
     # via prelude-python-sdk
-idna==3.4
+idna==3.11
     # via anyio
     # via httpx
     # via yarl
-multidict==6.4.4
+multidict==6.7.0
     # via aiohttp
     # via yarl
-propcache==0.3.1
+propcache==0.4.1
     # via aiohttp
     # via yarl
-pydantic==2.11.9
+pydantic==2.12.5
     # via prelude-python-sdk
-pydantic-core==2.33.2
+pydantic-core==2.41.5
     # via pydantic
-sniffio==1.3.0
-    # via anyio
+sniffio==1.3.1
     # via prelude-python-sdk
-typing-extensions==4.12.2
+typing-extensions==4.15.0
+    # via aiosignal
     # via anyio
+    # via exceptiongroup
     # via multidict
     # via prelude-python-sdk
     # via pydantic
     # via pydantic-core
     # via typing-inspection
-typing-inspection==0.4.1
+typing-inspection==0.4.2
     # via pydantic
-yarl==1.20.0
+yarl==1.22.0
     # via aiohttp

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/src/prelude_python_sdk/_client.py

@@ -21,7 +21,7 @@ from ._types import (
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import watch, lookup, verification, transactional, verification_management
+from .resources import watch, lookup, notify, verification, transactional, verification_management
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import PreludeError, APIStatusError
 from ._base_client import (
@@ -35,6 +35,7 @@ __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Prelude",
 
 class Prelude(SyncAPIClient):
     lookup: lookup.LookupResource
+    notify: notify.NotifyResource
     transactional: transactional.TransactionalResource
     verification: verification.VerificationResource
     verification_management: verification_management.VerificationManagementResource
@@ -97,6 +98,7 @@ class Prelude(SyncAPIClient):
         )
 
         self.lookup = lookup.LookupResource(self)
+        self.notify = notify.NotifyResource(self)
         self.transactional = transactional.TransactionalResource(self)
         self.verification = verification.VerificationResource(self)
         self.verification_management = verification_management.VerificationManagementResource(self)
@@ -211,6 +213,7 @@ class Prelude(SyncAPIClient):
 
 class AsyncPrelude(AsyncAPIClient):
     lookup: lookup.AsyncLookupResource
+    notify: notify.AsyncNotifyResource
     transactional: transactional.AsyncTransactionalResource
     verification: verification.AsyncVerificationResource
     verification_management: verification_management.AsyncVerificationManagementResource
@@ -273,6 +276,7 @@ class AsyncPrelude(AsyncAPIClient):
         )
 
         self.lookup = lookup.AsyncLookupResource(self)
+        self.notify = notify.AsyncNotifyResource(self)
         self.transactional = transactional.AsyncTransactionalResource(self)
         self.verification = verification.AsyncVerificationResource(self)
         self.verification_management = verification_management.AsyncVerificationManagementResource(self)
@@ -388,6 +392,7 @@ class AsyncPrelude(AsyncAPIClient):
 class PreludeWithRawResponse:
     def __init__(self, client: Prelude) -> None:
         self.lookup = lookup.LookupResourceWithRawResponse(client.lookup)
+        self.notify = notify.NotifyResourceWithRawResponse(client.notify)
         self.transactional = transactional.TransactionalResourceWithRawResponse(client.transactional)
         self.verification = verification.VerificationResourceWithRawResponse(client.verification)
         self.verification_management = verification_management.VerificationManagementResourceWithRawResponse(
@@ -399,6 +404,7 @@ class PreludeWithRawResponse:
 class AsyncPreludeWithRawResponse:
     def __init__(self, client: AsyncPrelude) -> None:
         self.lookup = lookup.AsyncLookupResourceWithRawResponse(client.lookup)
+        self.notify = notify.AsyncNotifyResourceWithRawResponse(client.notify)
         self.transactional = transactional.AsyncTransactionalResourceWithRawResponse(client.transactional)
         self.verification = verification.AsyncVerificationResourceWithRawResponse(client.verification)
         self.verification_management = verification_management.AsyncVerificationManagementResourceWithRawResponse(
@@ -410,6 +416,7 @@ class AsyncPreludeWithRawResponse:
 class PreludeWithStreamedResponse:
     def __init__(self, client: Prelude) -> None:
         self.lookup = lookup.LookupResourceWithStreamingResponse(client.lookup)
+        self.notify = notify.NotifyResourceWithStreamingResponse(client.notify)
         self.transactional = transactional.TransactionalResourceWithStreamingResponse(client.transactional)
         self.verification = verification.VerificationResourceWithStreamingResponse(client.verification)
         self.verification_management = verification_management.VerificationManagementResourceWithStreamingResponse(
@@ -421,6 +428,7 @@ class PreludeWithStreamedResponse:
 class AsyncPreludeWithStreamedResponse:
     def __init__(self, client: AsyncPrelude) -> None:
         self.lookup = lookup.AsyncLookupResourceWithStreamingResponse(client.lookup)
+        self.notify = notify.AsyncNotifyResourceWithStreamingResponse(client.notify)
         self.transactional = transactional.AsyncTransactionalResourceWithStreamingResponse(client.transactional)
         self.verification = verification.AsyncVerificationResourceWithStreamingResponse(client.verification)
         self.verification_management = verification_management.AsyncVerificationManagementResourceWithStreamingResponse(

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/src/prelude_python_sdk/_streaming.py

@@ -54,11 +54,12 @@ class Stream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        for sse in iterator:
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        response.close()
+        try:
+            for sse in iterator:
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            response.close()
 
     def __enter__(self) -> Self:
         return self
@@ -117,11 +118,12 @@ class AsyncStream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        async for sse in iterator:
-            yield process_data(data=sse.json(), cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        await response.aclose()
+        try:
+            async for sse in iterator:
+                yield process_data(data=sse.json(), cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            await response.aclose()
 
     async def __aenter__(self) -> Self:
         return self

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/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.9.0"  # x-release-please-version
+__version__ = "0.10.0"  # x-release-please-version

{prelude_python_sdk-0.9.0 → prelude_python_sdk-0.10.0}/src/prelude_python_sdk/resources/__init__.py

@@ -16,6 +16,14 @@ from .lookup import (
     LookupResourceWithStreamingResponse,
     AsyncLookupResourceWithStreamingResponse,
 )
+from .notify import (
+    NotifyResource,
+    AsyncNotifyResource,
+    NotifyResourceWithRawResponse,
+    AsyncNotifyResourceWithRawResponse,
+    NotifyResourceWithStreamingResponse,
+    AsyncNotifyResourceWithStreamingResponse,
+)
 from .verification import (
     VerificationResource,
     AsyncVerificationResource,
@@ -48,6 +56,12 @@ __all__ = [
     "AsyncLookupResourceWithRawResponse",
     "LookupResourceWithStreamingResponse",
     "AsyncLookupResourceWithStreamingResponse",
+    "NotifyResource",
+    "AsyncNotifyResource",
+    "NotifyResourceWithRawResponse",
+    "AsyncNotifyResourceWithRawResponse",
+    "NotifyResourceWithStreamingResponse",
+    "AsyncNotifyResourceWithStreamingResponse",
     "TransactionalResource",
     "AsyncTransactionalResource",
     "TransactionalResourceWithRawResponse",