prelude-python-sdk 0.2.0__tar.gz → 0.3.0__tar.gz

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

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

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.3.0 (2025-04-11)
+
+Full Changelog: [v0.2.0...v0.3.0](https://github.com/prelude-so/python-sdk/compare/v0.2.0...v0.3.0)
+
+### Features
+
+* **api:** update via SDK Studio ([e8db40d](https://github.com/prelude-so/python-sdk/commit/e8db40d0c6bb7ed120d01c7a5133e84611fa2dc5))
+* **api:** update via SDK Studio ([2738f74](https://github.com/prelude-so/python-sdk/commit/2738f749089da145689c78aabdedf810d3329826))
+
+
+### Bug Fixes
+
+* **ci:** ensure pip is always available ([#81](https://github.com/prelude-so/python-sdk/issues/81)) ([3496a08](https://github.com/prelude-so/python-sdk/commit/3496a088c4a51ff9755df7d5537031d2b66224b8))
+* **ci:** remove publishing patch ([#82](https://github.com/prelude-so/python-sdk/issues/82)) ([00fa879](https://github.com/prelude-so/python-sdk/commit/00fa8799dc14bc3d2dae941485f2e3a24bfb2bf3))
+* **perf:** optimize some hot paths ([6203988](https://github.com/prelude-so/python-sdk/commit/6203988ff6273cfe5135ec7d427c620a1094f6a1))
+* **perf:** skip traversing types for NotGiven values ([e5a8fd5](https://github.com/prelude-so/python-sdk/commit/e5a8fd59dd7168e68ff026e9d11d796e3d002241))
+* **types:** handle more discriminated union shapes ([#80](https://github.com/prelude-so/python-sdk/issues/80)) ([716195b](https://github.com/prelude-so/python-sdk/commit/716195b1874b4ec76cd39465810e3500c756eae8))
+
+
+### Chores
+
+* fix typos ([#83](https://github.com/prelude-so/python-sdk/issues/83)) ([ab98ad3](https://github.com/prelude-so/python-sdk/commit/ab98ad32961298cf1a2f47e6b3cc66a9f69cddbc))
+* **internal:** bump rye to 0.44.0 ([#78](https://github.com/prelude-so/python-sdk/issues/78)) ([436ceca](https://github.com/prelude-so/python-sdk/commit/436ceca01c22fd4015010d5bd3852ce319d0ed65))
+* **internal:** codegen related update ([#79](https://github.com/prelude-so/python-sdk/issues/79)) ([e5e9c6d](https://github.com/prelude-so/python-sdk/commit/e5e9c6d643232cad96a285dd7dc662f98684fbdc))
+* **internal:** expand CI branch coverage ([#87](https://github.com/prelude-so/python-sdk/issues/87)) ([3edb1aa](https://github.com/prelude-so/python-sdk/commit/3edb1aab16d2b38705d64969e9ac70fe00951ee6))
+* **internal:** reduce CI branch coverage ([70118ea](https://github.com/prelude-so/python-sdk/commit/70118ea5611c2f4337b21ac7da52a740bc52d7ff))
+* **internal:** remove extra empty newlines ([#76](https://github.com/prelude-so/python-sdk/issues/76)) ([3e52319](https://github.com/prelude-so/python-sdk/commit/3e5231901ad7bcc6e06a4c82aeaa619f759434f7))
+* **internal:** remove trailing character ([#84](https://github.com/prelude-so/python-sdk/issues/84)) ([526b990](https://github.com/prelude-so/python-sdk/commit/526b990f47cf42a44064d85ed2d8f9acbe35a609))
+* **internal:** slight transform perf improvement ([#85](https://github.com/prelude-so/python-sdk/issues/85)) ([b77e93b](https://github.com/prelude-so/python-sdk/commit/b77e93ba797273dd8a145183d9b9c712659163cd))
+* **tests:** improve enum examples ([#86](https://github.com/prelude-so/python-sdk/issues/86)) ([140d696](https://github.com/prelude-so/python-sdk/commit/140d6966a00666b4ade42fef7de7ec701cf697d3))
+
 ## 0.2.0 (2025-03-11)
 
 Full Changelog: [v0.1.0...v0.2.0](https://github.com/prelude-so/python-sdk/compare/v0.1.0...v0.2.0)

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

@@ -1,12 +1,11 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.3
 Name: prelude-python-sdk
-Version: 0.2.0
+Version: 0.3.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
 Author-email: Prelude <hello@prelude.so>
-License-Expression: Apache-2.0
-License-File: LICENSE
+License: Apache-2.0
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: MacOS

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/api.md

@@ -1,3 +1,15 @@
+# Lookup
+
+Types:
+
+```python
+from prelude_python_sdk.types import LookupLookupResponse
+```
+
+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>
+
 # Transactional
 
 Types:
@@ -28,10 +40,15 @@ Methods:
 Types:
 
 ```python
-from prelude_python_sdk.types import WatchFeedBackResponse, WatchPredictResponse
+from prelude_python_sdk.types import (
+    WatchPredictResponse,
+    WatchSendEventsResponse,
+    WatchSendFeedbacksResponse,
+)
 ```
 
 Methods:
 
-- <code title="post /v2/watch/feedback">client.watch.<a href="./src/prelude_python_sdk/resources/watch.py">feed_back</a>(\*\*<a href="src/prelude_python_sdk/types/watch_feed_back_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/watch_feed_back_response.py">WatchFeedBackResponse</a></code>
 - <code title="post /v2/watch/predict">client.watch.<a href="./src/prelude_python_sdk/resources/watch.py">predict</a>(\*\*<a href="src/prelude_python_sdk/types/watch_predict_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/watch_predict_response.py">WatchPredictResponse</a></code>
+- <code title="post /v2/watch/event">client.watch.<a href="./src/prelude_python_sdk/resources/watch.py">send_events</a>(\*\*<a href="src/prelude_python_sdk/types/watch_send_events_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/watch_send_events_response.py">WatchSendEventsResponse</a></code>
+- <code title="post /v2/watch/feedback">client.watch.<a href="./src/prelude_python_sdk/resources/watch.py">send_feedbacks</a>(\*\*<a href="src/prelude_python_sdk/types/watch_send_feedbacks_params.py">params</a>) -> <a href="./src/prelude_python_sdk/types/watch_send_feedbacks_response.py">WatchSendFeedbacksResponse</a></code>

prelude_python_sdk-0.3.0/bin/publish-pypi

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+
+set -eux
+mkdir -p dist
+rye build --clean
+rye publish --yes --token=$PYPI_TOKEN

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

@@ -1,6 +1,6 @@
 [project]
 name = "prelude-python-sdk"
-version = "0.2.0"
+version = "0.3.0"
 description = "The official Python library for the Prelude API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -38,7 +38,6 @@ Homepage = "https://github.com/prelude-so/python-sdk"
 Repository = "https://github.com/prelude-so/python-sdk"
 
 
-
 [tool.rye]
 managed = true
 # version pins are in requirements-dev.lock
@@ -87,7 +86,7 @@ typecheck = { chain = [
 "typecheck:mypy" = "mypy ."
 
 [build-system]
-requires = ["hatchling", "hatch-fancy-pypi-readme"]
+requires = ["hatchling==1.26.3", "hatch-fancy-pypi-readme"]
 build-backend = "hatchling.build"
 
 [tool.hatch.build]
@@ -152,7 +151,6 @@ reportImplicitOverride = true
 reportImportCycles = false
 reportPrivateUsage = false
 
-
 [tool.ruff]
 line-length = 120
 output-format = "grouped"

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/requirements-dev.lock

@@ -7,6 +7,7 @@
 #   all-features: true
 #   with-sources: false
 #   generate-hashes: false
+#   universal: false
 
 -e file:.
 annotated-types==0.6.0

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/requirements.lock

@@ -7,6 +7,7 @@
 #   all-features: true
 #   with-sources: false
 #   generate-hashes: false
+#   universal: false
 
 -e file:.
 annotated-types==0.6.0

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/src/prelude_python_sdk/_client.py

@@ -24,7 +24,7 @@ from ._utils import (
     get_async_library,
 )
 from ._version import __version__
-from .resources import watch, verification, transactional
+from .resources import watch, lookup, verification, transactional
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import PreludeError, APIStatusError
 from ._base_client import (
@@ -37,6 +37,7 @@ __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Prelude",
 
 
 class Prelude(SyncAPIClient):
+    lookup: lookup.LookupResource
     transactional: transactional.TransactionalResource
     verification: verification.VerificationResource
     watch: watch.WatchResource
@@ -97,6 +98,7 @@ class Prelude(SyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.lookup = lookup.LookupResource(self)
         self.transactional = transactional.TransactionalResource(self)
         self.verification = verification.VerificationResource(self)
         self.watch = watch.WatchResource(self)
@@ -209,6 +211,7 @@ class Prelude(SyncAPIClient):
 
 
 class AsyncPrelude(AsyncAPIClient):
+    lookup: lookup.AsyncLookupResource
     transactional: transactional.AsyncTransactionalResource
     verification: verification.AsyncVerificationResource
     watch: watch.AsyncWatchResource
@@ -269,6 +272,7 @@ class AsyncPrelude(AsyncAPIClient):
             _strict_response_validation=_strict_response_validation,
         )
 
+        self.lookup = lookup.AsyncLookupResource(self)
         self.transactional = transactional.AsyncTransactionalResource(self)
         self.verification = verification.AsyncVerificationResource(self)
         self.watch = watch.AsyncWatchResource(self)
@@ -382,6 +386,7 @@ class AsyncPrelude(AsyncAPIClient):
 
 class PreludeWithRawResponse:
     def __init__(self, client: Prelude) -> None:
+        self.lookup = lookup.LookupResourceWithRawResponse(client.lookup)
         self.transactional = transactional.TransactionalResourceWithRawResponse(client.transactional)
         self.verification = verification.VerificationResourceWithRawResponse(client.verification)
         self.watch = watch.WatchResourceWithRawResponse(client.watch)
@@ -389,6 +394,7 @@ class PreludeWithRawResponse:
 
 class AsyncPreludeWithRawResponse:
     def __init__(self, client: AsyncPrelude) -> None:
+        self.lookup = lookup.AsyncLookupResourceWithRawResponse(client.lookup)
         self.transactional = transactional.AsyncTransactionalResourceWithRawResponse(client.transactional)
         self.verification = verification.AsyncVerificationResourceWithRawResponse(client.verification)
         self.watch = watch.AsyncWatchResourceWithRawResponse(client.watch)
@@ -396,6 +402,7 @@ class AsyncPreludeWithRawResponse:
 
 class PreludeWithStreamedResponse:
     def __init__(self, client: Prelude) -> None:
+        self.lookup = lookup.LookupResourceWithStreamingResponse(client.lookup)
         self.transactional = transactional.TransactionalResourceWithStreamingResponse(client.transactional)
         self.verification = verification.VerificationResourceWithStreamingResponse(client.verification)
         self.watch = watch.WatchResourceWithStreamingResponse(client.watch)
@@ -403,6 +410,7 @@ class PreludeWithStreamedResponse:
 
 class AsyncPreludeWithStreamedResponse:
     def __init__(self, client: AsyncPrelude) -> None:
+        self.lookup = lookup.AsyncLookupResourceWithStreamingResponse(client.lookup)
         self.transactional = transactional.AsyncTransactionalResourceWithStreamingResponse(client.transactional)
         self.verification = verification.AsyncVerificationResourceWithStreamingResponse(client.verification)
         self.watch = watch.AsyncWatchResourceWithStreamingResponse(client.watch)

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/src/prelude_python_sdk/_models.py

@@ -65,7 +65,7 @@ from ._compat import (
 from ._constants import RAW_RESPONSE_HEADER
 
 if TYPE_CHECKING:
-    from pydantic_core.core_schema import ModelField, LiteralSchema, ModelFieldsSchema
+    from pydantic_core.core_schema import ModelField, ModelSchema, LiteralSchema, ModelFieldsSchema
 
 __all__ = ["BaseModel", "GenericModel"]
 
@@ -646,15 +646,18 @@ def _build_discriminated_union_meta(*, union: type, meta_annotations: tuple[Any,
 
 def _extract_field_schema_pv2(model: type[BaseModel], field_name: str) -> ModelField | None:
     schema = model.__pydantic_core_schema__
+    if schema["type"] == "definitions":
+        schema = schema["schema"]
+
     if schema["type"] != "model":
         return None
 
+    schema = cast("ModelSchema", schema)
     fields_schema = schema["schema"]
     if fields_schema["type"] != "model-fields":
         return None
 
     fields_schema = cast("ModelFieldsSchema", fields_schema)
-
     field = fields_schema["fields"].get(field_name)
     if not field:
         return None
@@ -678,7 +681,7 @@ def set_pydantic_config(typ: Any, config: pydantic.ConfigDict) -> None:
     setattr(typ, "__pydantic_config__", config)  # noqa: B010
 
 
-# our use of subclasssing here causes weirdness for type checkers,
+# our use of subclassing here causes weirdness for type checkers,
 # so we just pretend that we don't subclass
 if TYPE_CHECKING:
     GenericModel = BaseModel

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/src/prelude_python_sdk/_utils/_transform.py

@@ -5,13 +5,15 @@ import base64
 import pathlib
 from typing import Any, Mapping, TypeVar, cast
 from datetime import date, datetime
-from typing_extensions import Literal, get_args, override, get_type_hints
+from typing_extensions import Literal, get_args, override, get_type_hints as _get_type_hints
 
 import anyio
 import pydantic
 
 from ._utils import (
     is_list,
+    is_given,
+    lru_cache,
     is_mapping,
     is_iterable,
 )
@@ -108,6 +110,7 @@ def transform(
     return cast(_T, transformed)
 
 
+@lru_cache(maxsize=8096)
 def _get_annotated_type(type_: type) -> type | None:
     """If the given type is an `Annotated` type then it is returned, if not `None` is returned.
 
@@ -126,7 +129,7 @@ def _get_annotated_type(type_: type) -> type | None:
 def _maybe_transform_key(key: str, type_: type) -> str:
     """Transform the given `data` based on the annotations provided in `type_`.
 
-    Note: this function only looks at `Annotated` types that contain `PropertInfo` metadata.
+    Note: this function only looks at `Annotated` types that contain `PropertyInfo` metadata.
     """
     annotated_type = _get_annotated_type(type_)
     if annotated_type is None:
@@ -142,6 +145,10 @@ def _maybe_transform_key(key: str, type_: type) -> str:
     return key
 
 
+def _no_transform_needed(annotation: type) -> bool:
+    return annotation == float or annotation == int
+
+
 def _transform_recursive(
     data: object,
     *,
@@ -184,6 +191,15 @@ def _transform_recursive(
             return cast(object, data)
 
         inner_type = extract_type_arg(stripped_type, 0)
+        if _no_transform_needed(inner_type):
+            # for some types there is no need to transform anything, so we can get a small
+            # perf boost from skipping that work.
+            #
+            # but we still need to convert to a list to ensure the data is json-serializable
+            if is_list(data):
+                return data
+            return list(data)
+
         return [_transform_recursive(d, annotation=annotation, inner_type=inner_type) for d in data]
 
     if is_union_type(stripped_type):
@@ -245,6 +261,11 @@ def _transform_typeddict(
     result: dict[str, object] = {}
     annotations = get_type_hints(expected_type, include_extras=True)
     for key, value in data.items():
+        if not is_given(value):
+            # we don't need to include `NotGiven` values here as they'll
+            # be stripped out before the request is sent anyway
+            continue
+
         type_ = annotations.get(key)
         if type_ is None:
             # we do not have a type annotation for this field, leave it as is
@@ -332,6 +353,15 @@ async def _async_transform_recursive(
             return cast(object, data)
 
         inner_type = extract_type_arg(stripped_type, 0)
+        if _no_transform_needed(inner_type):
+            # for some types there is no need to transform anything, so we can get a small
+            # perf boost from skipping that work.
+            #
+            # but we still need to convert to a list to ensure the data is json-serializable
+            if is_list(data):
+                return data
+            return list(data)
+
         return [await _async_transform_recursive(d, annotation=annotation, inner_type=inner_type) for d in data]
 
     if is_union_type(stripped_type):
@@ -393,6 +423,11 @@ async def _async_transform_typeddict(
     result: dict[str, object] = {}
     annotations = get_type_hints(expected_type, include_extras=True)
     for key, value in data.items():
+        if not is_given(value):
+            # we don't need to include `NotGiven` values here as they'll
+            # be stripped out before the request is sent anyway
+            continue
+
         type_ = annotations.get(key)
         if type_ is None:
             # we do not have a type annotation for this field, leave it as is
@@ -400,3 +435,13 @@ async def _async_transform_typeddict(
         else:
             result[_maybe_transform_key(key, type_)] = await _async_transform_recursive(value, annotation=type_)
     return result
+
+
+@lru_cache(maxsize=8096)
+def get_type_hints(
+    obj: Any,
+    globalns: dict[str, Any] | None = None,
+    localns: Mapping[str, Any] | None = None,
+    include_extras: bool = False,
+) -> dict[str, Any]:
+    return _get_type_hints(obj, globalns=globalns, localns=localns, include_extras=include_extras)

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/src/prelude_python_sdk/_utils/_typing.py

@@ -13,6 +13,7 @@ from typing_extensions import (
     get_origin,
 )
 
+from ._utils import lru_cache
 from .._types import InheritsGeneric
 from .._compat import is_union as _is_union
 
@@ -66,6 +67,7 @@ def is_type_alias_type(tp: Any, /) -> TypeIs[typing_extensions.TypeAliasType]:
 
 
 # Extracts T from Annotated[T, ...] or from Required[Annotated[T, ...]]
+@lru_cache(maxsize=8096)
 def strip_annotated_type(typ: type) -> type:
     if is_required_type(typ) or is_annotated_type(typ):
         return strip_annotated_type(cast(type, get_args(typ)[0]))

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.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.2.0"  # x-release-please-version
+__version__ = "0.3.0"  # x-release-please-version

{prelude_python_sdk-0.2.0 → prelude_python_sdk-0.3.0}/src/prelude_python_sdk/resources/__init__.py

@@ -8,6 +8,14 @@ from .watch import (
     WatchResourceWithStreamingResponse,
     AsyncWatchResourceWithStreamingResponse,
 )
+from .lookup import (
+    LookupResource,
+    AsyncLookupResource,
+    LookupResourceWithRawResponse,
+    AsyncLookupResourceWithRawResponse,
+    LookupResourceWithStreamingResponse,
+    AsyncLookupResourceWithStreamingResponse,
+)
 from .verification import (
     VerificationResource,
     AsyncVerificationResource,
@@ -26,6 +34,12 @@ from .transactional import (
 )
 
 __all__ = [
+    "LookupResource",
+    "AsyncLookupResource",
+    "LookupResourceWithRawResponse",
+    "AsyncLookupResourceWithRawResponse",
+    "LookupResourceWithStreamingResponse",
+    "AsyncLookupResourceWithStreamingResponse",
     "TransactionalResource",
     "AsyncTransactionalResource",
     "TransactionalResourceWithRawResponse",

prelude_python_sdk-0.3.0/src/prelude_python_sdk/resources/lookup.py

@@ -0,0 +1,199 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Literal
+
+import httpx
+
+from ..types import lookup_lookup_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import (
+    maybe_transform,
+    async_maybe_transform,
+)
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.lookup_lookup_response import LookupLookupResponse
+
+__all__ = ["LookupResource", "AsyncLookupResource"]
+
+
+class LookupResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> LookupResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/prelude-so/python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return LookupResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> LookupResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/prelude-so/python-sdk#with_streaming_response
+        """
+        return LookupResourceWithStreamingResponse(self)
+
+    def lookup(
+        self,
+        phone_number: str,
+        *,
+        type: List[Literal["cnam"]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> LookupLookupResponse:
+        """
+        Retrieve detailed information about a phone number including carrier data, line
+        type, and portability status.
+
+        Args:
+          phone_number: An E.164 formatted phone number to look up.
+
+          type:
+              Optional features. Possible values are:
+
+              - `cnam` - Retrieve CNAM (Caller ID Name) along with other information. Contact
+                us if you need to use this functionality.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not phone_number:
+            raise ValueError(f"Expected a non-empty value for `phone_number` but received {phone_number!r}")
+        return self._get(
+            f"/v2/lookup/{phone_number}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"type": type}, lookup_lookup_params.LookupLookupParams),
+            ),
+            cast_to=LookupLookupResponse,
+        )
+
+
+class AsyncLookupResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncLookupResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/prelude-so/python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncLookupResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncLookupResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/prelude-so/python-sdk#with_streaming_response
+        """
+        return AsyncLookupResourceWithStreamingResponse(self)
+
+    async def lookup(
+        self,
+        phone_number: str,
+        *,
+        type: List[Literal["cnam"]] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> LookupLookupResponse:
+        """
+        Retrieve detailed information about a phone number including carrier data, line
+        type, and portability status.
+
+        Args:
+          phone_number: An E.164 formatted phone number to look up.
+
+          type:
+              Optional features. Possible values are:
+
+              - `cnam` - Retrieve CNAM (Caller ID Name) along with other information. Contact
+                us if you need to use this functionality.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not phone_number:
+            raise ValueError(f"Expected a non-empty value for `phone_number` but received {phone_number!r}")
+        return await self._get(
+            f"/v2/lookup/{phone_number}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"type": type}, lookup_lookup_params.LookupLookupParams),
+            ),
+            cast_to=LookupLookupResponse,
+        )
+
+
+class LookupResourceWithRawResponse:
+    def __init__(self, lookup: LookupResource) -> None:
+        self._lookup = lookup
+
+        self.lookup = to_raw_response_wrapper(
+            lookup.lookup,
+        )
+
+
+class AsyncLookupResourceWithRawResponse:
+    def __init__(self, lookup: AsyncLookupResource) -> None:
+        self._lookup = lookup
+
+        self.lookup = async_to_raw_response_wrapper(
+            lookup.lookup,
+        )
+
+
+class LookupResourceWithStreamingResponse:
+    def __init__(self, lookup: LookupResource) -> None:
+        self._lookup = lookup
+
+        self.lookup = to_streamed_response_wrapper(
+            lookup.lookup,
+        )
+
+
+class AsyncLookupResourceWithStreamingResponse:
+    def __init__(self, lookup: AsyncLookupResource) -> None:
+        self._lookup = lookup
+
+        self.lookup = async_to_streamed_response_wrapper(
+            lookup.lookup,
+        )