perplexityai 0.10.0__py3-none-any.whl → 0.12.0__py3-none-any.whl

perplexity/__init__.py

@@ -3,7 +3,7 @@
 import typing as _t
 
 from . import types
-from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
+from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes, omit, not_given
 from ._utils import file_from_path
 from ._client import (
     Client,
@@ -48,7 +48,9 @@ __all__ = [
     "ProxiesTypes",
     "NotGiven",
     "NOT_GIVEN",
+    "not_given",
     "Omit",
+    "omit",
     "PerplexityError",
     "APIError",
     "APIStatusError",

perplexity/_base_client.py

@@ -42,7 +42,6 @@ from . import _exceptions
 from ._qs import Querystring
 from ._files import to_httpx_files, async_to_httpx_files
 from ._types import (
-    NOT_GIVEN,
     Body,
     Omit,
     Query,
@@ -57,6 +56,7 @@ from ._types import (
     RequestOptions,
     HttpxRequestFiles,
     ModelBuilderProtocol,
+    not_given,
 )
 from ._utils import is_dict, is_list, asyncify, is_given, lru_cache, is_mapping
 from ._compat import PYDANTIC_V1, model_copy, model_dump
@@ -145,9 +145,9 @@ class PageInfo:
     def __init__(
         self,
         *,
-        url: URL | NotGiven = NOT_GIVEN,
-        json: Body | NotGiven = NOT_GIVEN,
-        params: Query | NotGiven = NOT_GIVEN,
+        url: URL | NotGiven = not_given,
+        json: Body | NotGiven = not_given,
+        params: Query | NotGiven = not_given,
     ) -> None:
         self.url = url
         self.json = json
@@ -595,7 +595,7 @@ class BaseClient(Generic[_HttpxClientT, _DefaultStreamT]):
         # we internally support defining a temporary header to override the
         # default `cast_to` type for use with `.with_raw_response` and `.with_streaming_response`
         # see _response.py for implementation details
-        override_cast_to = headers.pop(OVERRIDE_CAST_TO_HEADER, NOT_GIVEN)
+        override_cast_to = headers.pop(OVERRIDE_CAST_TO_HEADER, not_given)
         if is_given(override_cast_to):
             options.headers = headers
             return cast(Type[ResponseT], override_cast_to)
@@ -825,7 +825,7 @@ class SyncAPIClient(BaseClient[httpx.Client, Stream[Any]]):
         version: str,
         base_url: str | URL,
         max_retries: int = DEFAULT_MAX_RETRIES,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
         custom_headers: Mapping[str, str] | None = None,
         custom_query: Mapping[str, object] | None = None,
@@ -1356,7 +1356,7 @@ class AsyncAPIClient(BaseClient[httpx.AsyncClient, AsyncStream[Any]]):
         base_url: str | URL,
         _strict_response_validation: bool,
         max_retries: int = DEFAULT_MAX_RETRIES,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
         custom_headers: Mapping[str, str] | None = None,
         custom_query: Mapping[str, object] | None = None,
@@ -1818,8 +1818,8 @@ def make_request_options(
     extra_query: Query | None = None,
     extra_body: Body | None = None,
     idempotency_key: str | None = None,
-    timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    post_parser: PostParser | NotGiven = NOT_GIVEN,
+    timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    post_parser: PostParser | NotGiven = not_given,
 ) -> RequestOptions:
     """Create a dict of type RequestOptions without keys of NotGiven values."""
     options: RequestOptions = {}

perplexity/_client.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 import os
-from typing import Any, Union, Mapping
+from typing import Any, Mapping
 from typing_extensions import Self, override
 
 import httpx
@@ -11,13 +11,13 @@ import httpx
 from . import _exceptions
 from ._qs import Querystring
 from ._types import (
-    NOT_GIVEN,
     Omit,
     Timeout,
     NotGiven,
     Transport,
     ProxiesTypes,
     RequestOptions,
+    not_given,
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
@@ -59,7 +59,7 @@ class Perplexity(SyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -136,9 +136,9 @@ class Perplexity(SyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.Client | None = None,
-        max_retries: int | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = not_given,
         default_headers: Mapping[str, str] | None = None,
         set_default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -231,7 +231,7 @@ class AsyncPerplexity(AsyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,
@@ -308,9 +308,9 @@ class AsyncPerplexity(AsyncAPIClient):
         *,
         api_key: str | None = None,
         base_url: str | httpx.URL | None = None,
-        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | Timeout | None | NotGiven = not_given,
         http_client: httpx.AsyncClient | None = None,
-        max_retries: int | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = not_given,
         default_headers: Mapping[str, str] | None = None,
         set_default_headers: Mapping[str, str] | None = None,
         default_query: Mapping[str, object] | None = None,

perplexity/_qs.py

@@ -4,7 +4,7 @@ from typing import Any, List, Tuple, Union, Mapping, TypeVar
 from urllib.parse import parse_qs, urlencode
 from typing_extensions import Literal, get_args
 
-from ._types import NOT_GIVEN, NotGiven, NotGivenOr
+from ._types import NotGiven, not_given
 from ._utils import flatten
 
 _T = TypeVar("_T")
@@ -41,8 +41,8 @@ class Querystring:
         self,
         params: Params,
         *,
-        array_format: NotGivenOr[ArrayFormat] = NOT_GIVEN,
-        nested_format: NotGivenOr[NestedFormat] = NOT_GIVEN,
+        array_format: ArrayFormat | NotGiven = not_given,
+        nested_format: NestedFormat | NotGiven = not_given,
     ) -> str:
         return urlencode(
             self.stringify_items(
@@ -56,8 +56,8 @@ class Querystring:
         self,
         params: Params,
         *,
-        array_format: NotGivenOr[ArrayFormat] = NOT_GIVEN,
-        nested_format: NotGivenOr[NestedFormat] = NOT_GIVEN,
+        array_format: ArrayFormat | NotGiven = not_given,
+        nested_format: NestedFormat | NotGiven = not_given,
     ) -> list[tuple[str, str]]:
         opts = Options(
             qs=self,
@@ -143,8 +143,8 @@ class Options:
         self,
         qs: Querystring = _qs,
         *,
-        array_format: NotGivenOr[ArrayFormat] = NOT_GIVEN,
-        nested_format: NotGivenOr[NestedFormat] = NOT_GIVEN,
+        array_format: ArrayFormat | NotGiven = not_given,
+        nested_format: NestedFormat | NotGiven = not_given,
     ) -> None:
         self.array_format = qs.array_format if isinstance(array_format, NotGiven) else array_format
         self.nested_format = qs.nested_format if isinstance(nested_format, NotGiven) else nested_format

perplexity/_types.py

@@ -117,18 +117,21 @@ class RequestOptions(TypedDict, total=False):
 # Sentinel class used until PEP 0661 is accepted
 class NotGiven:
     """
-    A sentinel singleton class used to distinguish omitted keyword arguments
-    from those passed in with the value None (which may have different behavior).
+    For parameters with a meaningful None value, we need to distinguish between
+    the user explicitly passing None, and the user not passing the parameter at
+    all.
+
+    User code shouldn't need to use not_given directly.
 
     For example:
 
     ```py
-    def get(timeout: Union[int, NotGiven, None] = NotGiven()) -> Response: ...
+    def create(timeout: Timeout | None | NotGiven = not_given): ...
 
 
-    get(timeout=1)  # 1s timeout
-    get(timeout=None)  # No timeout
-    get()  # Default timeout behavior, which may not be statically known at the method definition.
+    create(timeout=1)  # 1s timeout
+    create(timeout=None)  # No timeout
+    create()  # Default timeout behavior
     ```
     """
 
@@ -140,13 +143,14 @@ class NotGiven:
         return "NOT_GIVEN"
 
 
-NotGivenOr = Union[_T, NotGiven]
+not_given = NotGiven()
+# for backwards compatibility:
 NOT_GIVEN = NotGiven()
 
 
 class Omit:
-    """In certain situations you need to be able to represent a case where a default value has
-    to be explicitly removed and `None` is not an appropriate substitute, for example:
+    """
+    To explicitly omit something from being sent in a request, use `omit`.
 
     ```py
     # as the default `Content-Type` header is `application/json` that will be sent
@@ -156,8 +160,8 @@ class Omit:
     # to look something like: 'multipart/form-data; boundary=0d8382fcf5f8c3be01ca2e11002d2983'
     client.post(..., headers={"Content-Type": "multipart/form-data"})
 
-    # instead you can remove the default `application/json` header by passing Omit
-    client.post(..., headers={"Content-Type": Omit()})
+    # instead you can remove the default `application/json` header by passing omit
+    client.post(..., headers={"Content-Type": omit})
     ```
     """
 
@@ -165,6 +169,9 @@ class Omit:
         return False
 
 
+omit = Omit()
+
+
 @runtime_checkable
 class ModelBuilderProtocol(Protocol):
     @classmethod

perplexity/_utils/_transform.py

@@ -268,7 +268,7 @@ def _transform_typeddict(
     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
+            # we don't need to include omitted values here as they'll
             # be stripped out before the request is sent anyway
             continue
 
@@ -434,7 +434,7 @@ async def _async_transform_typeddict(
     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
+            # we don't need to include omitted values here as they'll
             # be stripped out before the request is sent anyway
             continue
 

perplexity/_utils/_utils.py

@@ -21,7 +21,7 @@ from typing_extensions import TypeGuard
 
 import sniffio
 
-from .._types import NotGiven, FileTypes, NotGivenOr, HeadersLike
+from .._types import Omit, NotGiven, FileTypes, HeadersLike
 
 _T = TypeVar("_T")
 _TupleT = TypeVar("_TupleT", bound=Tuple[object, ...])
@@ -63,7 +63,7 @@ def _extract_items(
     try:
         key = path[index]
     except IndexError:
-        if isinstance(obj, NotGiven):
+        if not is_given(obj):
             # no value was provided - we can safely ignore
             return []
 
@@ -126,8 +126,8 @@ def _extract_items(
     return []
 
 
-def is_given(obj: NotGivenOr[_T]) -> TypeGuard[_T]:
-    return not isinstance(obj, NotGiven)
+def is_given(obj: _T | NotGiven | Omit) -> TypeGuard[_T]:
+    return not isinstance(obj, NotGiven) and not isinstance(obj, Omit)
 
 
 # Type safe methods for narrowing types with TypeVars.

perplexity/_version.py

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

perplexity/resources/async_/async_.py

@@ -27,7 +27,7 @@ class AsyncResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncResourceWithRawResponse(self)
 
@@ -36,7 +36,7 @@ class AsyncResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncResourceWithStreamingResponse(self)
 
@@ -52,7 +52,7 @@ class AsyncAsyncResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncAsyncResourceWithRawResponse(self)
 
@@ -61,7 +61,7 @@ class AsyncAsyncResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncAsyncResourceWithStreamingResponse(self)
 

perplexity/resources/async_/chat/chat.py

@@ -27,7 +27,7 @@ class ChatResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return ChatResourceWithRawResponse(self)
 
@@ -36,7 +36,7 @@ class ChatResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return ChatResourceWithStreamingResponse(self)
 
@@ -52,7 +52,7 @@ class AsyncChatResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncChatResourceWithRawResponse(self)
 
@@ -61,7 +61,7 @@ class AsyncChatResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncChatResourceWithStreamingResponse(self)
 

perplexity/resources/async_/chat/completions.py

@@ -6,7 +6,7 @@ from typing import Optional
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
 from ...._utils import maybe_transform, strip_not_given, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -32,7 +32,7 @@ class CompletionsResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return CompletionsResourceWithRawResponse(self)
 
@@ -41,7 +41,7 @@ class CompletionsResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return CompletionsResourceWithStreamingResponse(self)
 
@@ -49,13 +49,13 @@ class CompletionsResource(SyncAPIResource):
         self,
         *,
         request: completion_create_params.Request,
-        idempotency_key: Optional[str] | NotGiven = NOT_GIVEN,
+        idempotency_key: Optional[str] | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
         FastAPI wrapper around async chat completions
@@ -95,7 +95,7 @@ class CompletionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
         """list all async chat completion requests for a given user."""
         return self._get(
@@ -110,18 +110,18 @@ class CompletionsResource(SyncAPIResource):
         self,
         api_request: str,
         *,
-        local_mode: bool | NotGiven = NOT_GIVEN,
-        x_client_env: str | NotGiven = NOT_GIVEN,
-        x_client_name: str | NotGiven = NOT_GIVEN,
-        x_request_time: str | NotGiven = NOT_GIVEN,
-        x_usage_tier: str | NotGiven = NOT_GIVEN,
-        x_user_id: str | NotGiven = NOT_GIVEN,
+        local_mode: bool | Omit = omit,
+        x_client_env: str | Omit = omit,
+        x_client_name: str | Omit = omit,
+        x_request_time: str | Omit = omit,
+        x_usage_tier: str | Omit = omit,
+        x_user_id: str | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
         get the response for a given async chat completion request.
@@ -169,7 +169,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncCompletionsResourceWithRawResponse(self)
 
@@ -178,7 +178,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncCompletionsResourceWithStreamingResponse(self)
 
@@ -186,13 +186,13 @@ class AsyncCompletionsResource(AsyncAPIResource):
         self,
         *,
         request: completion_create_params.Request,
-        idempotency_key: Optional[str] | NotGiven = NOT_GIVEN,
+        idempotency_key: Optional[str] | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
         FastAPI wrapper around async chat completions
@@ -232,7 +232,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionListResponse:
         """list all async chat completion requests for a given user."""
         return await self._get(
@@ -247,18 +247,18 @@ class AsyncCompletionsResource(AsyncAPIResource):
         self,
         api_request: str,
         *,
-        local_mode: bool | NotGiven = NOT_GIVEN,
-        x_client_env: str | NotGiven = NOT_GIVEN,
-        x_client_name: str | NotGiven = NOT_GIVEN,
-        x_request_time: str | NotGiven = NOT_GIVEN,
-        x_usage_tier: str | NotGiven = NOT_GIVEN,
-        x_user_id: str | NotGiven = NOT_GIVEN,
+        local_mode: bool | Omit = omit,
+        x_client_env: str | Omit = omit,
+        x_client_name: str | Omit = omit,
+        x_request_time: str | Omit = omit,
+        x_usage_tier: str | Omit = omit,
+        x_user_id: str | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionGetResponse:
         """
         get the response for a given async chat completion request.

perplexity/resources/chat/chat.py

@@ -27,7 +27,7 @@ class ChatResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return ChatResourceWithRawResponse(self)
 
@@ -36,7 +36,7 @@ class ChatResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return ChatResourceWithStreamingResponse(self)
 
@@ -52,7 +52,7 @@ class AsyncChatResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncChatResourceWithRawResponse(self)
 
@@ -61,7 +61,7 @@ class AsyncChatResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncChatResourceWithStreamingResponse(self)
 

perplexity/resources/chat/completions.py

@@ -7,7 +7,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
+from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
@@ -32,7 +32,7 @@ class CompletionsResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return CompletionsResourceWithRawResponse(self)
 
@@ -41,7 +41,7 @@ class CompletionsResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return CompletionsResourceWithStreamingResponse(self)
 
@@ -50,64 +50,64 @@ class CompletionsResource(SyncAPIResource):
         *,
         messages: Iterable[ChatMessageInput],
         model: str,
-        _debug_pro_search: bool | NotGiven = NOT_GIVEN,
-        _inputs: Optional[Iterable[int]] | NotGiven = NOT_GIVEN,
-        _is_browser_agent: Optional[bool] | NotGiven = NOT_GIVEN,
-        _prompt_token_length: Optional[int] | NotGiven = NOT_GIVEN,
-        best_of: Optional[int] | NotGiven = NOT_GIVEN,
-        country: Optional[str] | NotGiven = NOT_GIVEN,
-        cum_logprobs: Optional[bool] | NotGiven = NOT_GIVEN,
-        debug_params: Optional[completion_create_params.DebugParams] | NotGiven = NOT_GIVEN,
-        disable_search: Optional[bool] | NotGiven = NOT_GIVEN,
-        diverse_first_token: Optional[bool] | NotGiven = NOT_GIVEN,
-        enable_search_classifier: Optional[bool] | NotGiven = NOT_GIVEN,
-        file_workspace_id: Optional[str] | NotGiven = NOT_GIVEN,
-        frequency_penalty: Optional[float] | NotGiven = NOT_GIVEN,
-        has_image_url: bool | NotGiven = NOT_GIVEN,
-        image_domain_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        image_format_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        last_updated_after_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        last_updated_before_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        latitude: Optional[float] | NotGiven = NOT_GIVEN,
-        logprobs: Optional[bool] | NotGiven = NOT_GIVEN,
-        longitude: Optional[float] | NotGiven = NOT_GIVEN,
-        max_tokens: Optional[int] | NotGiven = NOT_GIVEN,
-        n: Optional[int] | NotGiven = NOT_GIVEN,
-        num_images: int | NotGiven = NOT_GIVEN,
-        num_search_results: int | NotGiven = NOT_GIVEN,
-        parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
-        presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
-        ranking_model: Optional[str] | NotGiven = NOT_GIVEN,
-        reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] | NotGiven = NOT_GIVEN,
-        response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
-        response_metadata: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        return_images: Optional[bool] | NotGiven = NOT_GIVEN,
-        return_related_questions: Optional[bool] | NotGiven = NOT_GIVEN,
-        safe_search: Optional[bool] | NotGiven = NOT_GIVEN,
-        search_after_date_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        search_before_date_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        search_domain_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        search_internal_properties: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        search_mode: Optional[Literal["web", "academic", "sec"]] | NotGiven = NOT_GIVEN,
-        search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | NotGiven = NOT_GIVEN,
-        search_tenant: Optional[str] | NotGiven = NOT_GIVEN,
-        stop: Union[str, SequenceNotStr[str], None] | NotGiven = NOT_GIVEN,
-        stream: Optional[bool] | NotGiven = NOT_GIVEN,
-        temperature: Optional[float] | NotGiven = NOT_GIVEN,
-        tool_choice: Optional[Literal["none", "auto", "required"]] | NotGiven = NOT_GIVEN,
-        tools: Optional[Iterable[completion_create_params.Tool]] | NotGiven = NOT_GIVEN,
-        top_k: Optional[int] | NotGiven = NOT_GIVEN,
-        top_logprobs: Optional[int] | NotGiven = NOT_GIVEN,
-        top_p: Optional[float] | NotGiven = NOT_GIVEN,
-        updated_after_timestamp: Optional[int] | NotGiven = NOT_GIVEN,
-        updated_before_timestamp: Optional[int] | NotGiven = NOT_GIVEN,
-        web_search_options: completion_create_params.WebSearchOptions | NotGiven = NOT_GIVEN,
+        _debug_pro_search: bool | Omit = omit,
+        _inputs: Optional[Iterable[int]] | Omit = omit,
+        _is_browser_agent: Optional[bool] | Omit = omit,
+        _prompt_token_length: Optional[int] | Omit = omit,
+        best_of: Optional[int] | Omit = omit,
+        country: Optional[str] | Omit = omit,
+        cum_logprobs: Optional[bool] | Omit = omit,
+        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
+        disable_search: Optional[bool] | Omit = omit,
+        diverse_first_token: Optional[bool] | Omit = omit,
+        enable_search_classifier: Optional[bool] | Omit = omit,
+        file_workspace_id: Optional[str] | Omit = omit,
+        frequency_penalty: Optional[float] | Omit = omit,
+        has_image_url: bool | Omit = omit,
+        image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        last_updated_after_filter: Optional[str] | Omit = omit,
+        last_updated_before_filter: Optional[str] | Omit = omit,
+        latitude: Optional[float] | Omit = omit,
+        logprobs: Optional[bool] | Omit = omit,
+        longitude: Optional[float] | Omit = omit,
+        max_tokens: Optional[int] | Omit = omit,
+        n: Optional[int] | Omit = omit,
+        num_images: int | Omit = omit,
+        num_search_results: int | Omit = omit,
+        parallel_tool_calls: Optional[bool] | Omit = omit,
+        presence_penalty: Optional[float] | Omit = omit,
+        ranking_model: Optional[str] | Omit = omit,
+        reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] | Omit = omit,
+        response_format: Optional[completion_create_params.ResponseFormat] | Omit = omit,
+        response_metadata: Optional[Dict[str, object]] | Omit = omit,
+        return_images: Optional[bool] | Omit = omit,
+        return_related_questions: Optional[bool] | Omit = omit,
+        safe_search: Optional[bool] | Omit = omit,
+        search_after_date_filter: Optional[str] | Omit = omit,
+        search_before_date_filter: Optional[str] | Omit = omit,
+        search_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        search_internal_properties: Optional[Dict[str, object]] | Omit = omit,
+        search_mode: Optional[Literal["web", "academic", "sec"]] | Omit = omit,
+        search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
+        search_tenant: Optional[str] | Omit = omit,
+        stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream: Optional[bool] | Omit = omit,
+        temperature: Optional[float] | Omit = omit,
+        tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
+        tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
+        top_k: Optional[int] | Omit = omit,
+        top_logprobs: Optional[int] | Omit = omit,
+        top_p: Optional[float] | Omit = omit,
+        updated_after_timestamp: Optional[int] | Omit = omit,
+        updated_before_timestamp: Optional[int] | Omit = omit,
+        web_search_options: completion_create_params.WebSearchOptions | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
         FastAPI wrapper around chat completions
@@ -196,7 +196,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncCompletionsResourceWithRawResponse(self)
 
@@ -205,7 +205,7 @@ class AsyncCompletionsResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncCompletionsResourceWithStreamingResponse(self)
 
@@ -214,64 +214,64 @@ class AsyncCompletionsResource(AsyncAPIResource):
         *,
         messages: Iterable[ChatMessageInput],
         model: str,
-        _debug_pro_search: bool | NotGiven = NOT_GIVEN,
-        _inputs: Optional[Iterable[int]] | NotGiven = NOT_GIVEN,
-        _is_browser_agent: Optional[bool] | NotGiven = NOT_GIVEN,
-        _prompt_token_length: Optional[int] | NotGiven = NOT_GIVEN,
-        best_of: Optional[int] | NotGiven = NOT_GIVEN,
-        country: Optional[str] | NotGiven = NOT_GIVEN,
-        cum_logprobs: Optional[bool] | NotGiven = NOT_GIVEN,
-        debug_params: Optional[completion_create_params.DebugParams] | NotGiven = NOT_GIVEN,
-        disable_search: Optional[bool] | NotGiven = NOT_GIVEN,
-        diverse_first_token: Optional[bool] | NotGiven = NOT_GIVEN,
-        enable_search_classifier: Optional[bool] | NotGiven = NOT_GIVEN,
-        file_workspace_id: Optional[str] | NotGiven = NOT_GIVEN,
-        frequency_penalty: Optional[float] | NotGiven = NOT_GIVEN,
-        has_image_url: bool | NotGiven = NOT_GIVEN,
-        image_domain_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        image_format_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        last_updated_after_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        last_updated_before_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        latitude: Optional[float] | NotGiven = NOT_GIVEN,
-        logprobs: Optional[bool] | NotGiven = NOT_GIVEN,
-        longitude: Optional[float] | NotGiven = NOT_GIVEN,
-        max_tokens: Optional[int] | NotGiven = NOT_GIVEN,
-        n: Optional[int] | NotGiven = NOT_GIVEN,
-        num_images: int | NotGiven = NOT_GIVEN,
-        num_search_results: int | NotGiven = NOT_GIVEN,
-        parallel_tool_calls: Optional[bool] | NotGiven = NOT_GIVEN,
-        presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
-        ranking_model: Optional[str] | NotGiven = NOT_GIVEN,
-        reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] | NotGiven = NOT_GIVEN,
-        response_format: Optional[completion_create_params.ResponseFormat] | NotGiven = NOT_GIVEN,
-        response_metadata: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        return_images: Optional[bool] | NotGiven = NOT_GIVEN,
-        return_related_questions: Optional[bool] | NotGiven = NOT_GIVEN,
-        safe_search: Optional[bool] | NotGiven = NOT_GIVEN,
-        search_after_date_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        search_before_date_filter: Optional[str] | NotGiven = NOT_GIVEN,
-        search_domain_filter: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
-        search_internal_properties: Optional[Dict[str, object]] | NotGiven = NOT_GIVEN,
-        search_mode: Optional[Literal["web", "academic", "sec"]] | NotGiven = NOT_GIVEN,
-        search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | NotGiven = NOT_GIVEN,
-        search_tenant: Optional[str] | NotGiven = NOT_GIVEN,
-        stop: Union[str, SequenceNotStr[str], None] | NotGiven = NOT_GIVEN,
-        stream: Optional[bool] | NotGiven = NOT_GIVEN,
-        temperature: Optional[float] | NotGiven = NOT_GIVEN,
-        tool_choice: Optional[Literal["none", "auto", "required"]] | NotGiven = NOT_GIVEN,
-        tools: Optional[Iterable[completion_create_params.Tool]] | NotGiven = NOT_GIVEN,
-        top_k: Optional[int] | NotGiven = NOT_GIVEN,
-        top_logprobs: Optional[int] | NotGiven = NOT_GIVEN,
-        top_p: Optional[float] | NotGiven = NOT_GIVEN,
-        updated_after_timestamp: Optional[int] | NotGiven = NOT_GIVEN,
-        updated_before_timestamp: Optional[int] | NotGiven = NOT_GIVEN,
-        web_search_options: completion_create_params.WebSearchOptions | NotGiven = NOT_GIVEN,
+        _debug_pro_search: bool | Omit = omit,
+        _inputs: Optional[Iterable[int]] | Omit = omit,
+        _is_browser_agent: Optional[bool] | Omit = omit,
+        _prompt_token_length: Optional[int] | Omit = omit,
+        best_of: Optional[int] | Omit = omit,
+        country: Optional[str] | Omit = omit,
+        cum_logprobs: Optional[bool] | Omit = omit,
+        debug_params: Optional[completion_create_params.DebugParams] | Omit = omit,
+        disable_search: Optional[bool] | Omit = omit,
+        diverse_first_token: Optional[bool] | Omit = omit,
+        enable_search_classifier: Optional[bool] | Omit = omit,
+        file_workspace_id: Optional[str] | Omit = omit,
+        frequency_penalty: Optional[float] | Omit = omit,
+        has_image_url: bool | Omit = omit,
+        image_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        image_format_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        last_updated_after_filter: Optional[str] | Omit = omit,
+        last_updated_before_filter: Optional[str] | Omit = omit,
+        latitude: Optional[float] | Omit = omit,
+        logprobs: Optional[bool] | Omit = omit,
+        longitude: Optional[float] | Omit = omit,
+        max_tokens: Optional[int] | Omit = omit,
+        n: Optional[int] | Omit = omit,
+        num_images: int | Omit = omit,
+        num_search_results: int | Omit = omit,
+        parallel_tool_calls: Optional[bool] | Omit = omit,
+        presence_penalty: Optional[float] | Omit = omit,
+        ranking_model: Optional[str] | Omit = omit,
+        reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] | Omit = omit,
+        response_format: Optional[completion_create_params.ResponseFormat] | Omit = omit,
+        response_metadata: Optional[Dict[str, object]] | Omit = omit,
+        return_images: Optional[bool] | Omit = omit,
+        return_related_questions: Optional[bool] | Omit = omit,
+        safe_search: Optional[bool] | Omit = omit,
+        search_after_date_filter: Optional[str] | Omit = omit,
+        search_before_date_filter: Optional[str] | Omit = omit,
+        search_domain_filter: Optional[SequenceNotStr[str]] | Omit = omit,
+        search_internal_properties: Optional[Dict[str, object]] | Omit = omit,
+        search_mode: Optional[Literal["web", "academic", "sec"]] | Omit = omit,
+        search_recency_filter: Optional[Literal["hour", "day", "week", "month", "year"]] | Omit = omit,
+        search_tenant: Optional[str] | Omit = omit,
+        stop: Union[str, SequenceNotStr[str], None] | Omit = omit,
+        stream: Optional[bool] | Omit = omit,
+        temperature: Optional[float] | Omit = omit,
+        tool_choice: Optional[Literal["none", "auto", "required"]] | Omit = omit,
+        tools: Optional[Iterable[completion_create_params.Tool]] | Omit = omit,
+        top_k: Optional[int] | Omit = omit,
+        top_logprobs: Optional[int] | Omit = omit,
+        top_p: Optional[float] | Omit = omit,
+        updated_after_timestamp: Optional[int] | Omit = omit,
+        updated_before_timestamp: Optional[int] | Omit = omit,
+        web_search_options: completion_create_params.WebSearchOptions | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> CompletionCreateResponse:
         """
         FastAPI wrapper around chat completions

perplexity/resources/search.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import search_create_params
-from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -31,7 +31,7 @@ class SearchResource(SyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return SearchResourceWithRawResponse(self)
 
@@ -40,7 +40,7 @@ class SearchResource(SyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return SearchResourceWithStreamingResponse(self)
 
@@ -48,16 +48,17 @@ class SearchResource(SyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        max_results: int | NotGiven = NOT_GIVEN,
-        max_tokens: int | NotGiven = NOT_GIVEN,
-        max_tokens_per_page: int | NotGiven = NOT_GIVEN,
-        search_mode: Optional[Literal["web", "academic", "sec"]] | NotGiven = NOT_GIVEN,
+        country: Optional[str] | Omit = omit,
+        max_results: int | Omit = omit,
+        max_tokens: int | Omit = omit,
+        max_tokens_per_page: int | Omit = omit,
+        search_mode: Optional[Literal["web", "academic", "sec"]] | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
         Search
@@ -76,6 +77,7 @@ class SearchResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "query": query,
+                    "country": country,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,
@@ -97,7 +99,7 @@ class AsyncSearchResource(AsyncAPIResource):
         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/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/perplexityai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncSearchResourceWithRawResponse(self)
 
@@ -106,7 +108,7 @@ class AsyncSearchResource(AsyncAPIResource):
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
+        For more information, see https://www.github.com/perplexityai/perplexity-py#with_streaming_response
         """
         return AsyncSearchResourceWithStreamingResponse(self)
 
@@ -114,16 +116,17 @@ class AsyncSearchResource(AsyncAPIResource):
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
-        max_results: int | NotGiven = NOT_GIVEN,
-        max_tokens: int | NotGiven = NOT_GIVEN,
-        max_tokens_per_page: int | NotGiven = NOT_GIVEN,
-        search_mode: Optional[Literal["web", "academic", "sec"]] | NotGiven = NOT_GIVEN,
+        country: Optional[str] | Omit = omit,
+        max_results: int | Omit = omit,
+        max_tokens: int | Omit = omit,
+        max_tokens_per_page: int | Omit = omit,
+        search_mode: Optional[Literal["web", "academic", "sec"]] | Omit = omit,
         # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SearchCreateResponse:
         """
         Search
@@ -142,6 +145,7 @@ class AsyncSearchResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "query": query,
+                    "country": country,
                     "max_results": max_results,
                     "max_tokens": max_tokens,
                     "max_tokens_per_page": max_tokens_per_page,

perplexity/types/search_create_params.py

@@ -13,6 +13,8 @@ __all__ = ["SearchCreateParams"]
 class SearchCreateParams(TypedDict, total=False):
     query: Required[Union[str, SequenceNotStr[str]]]
 
+    country: Optional[str]
+
     max_results: int
 
     max_tokens: int

{perplexityai-0.10.0.dist-info → perplexityai-0.12.0.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.3
 Name: perplexityai
-Version: 0.10.0
+Version: 0.12.0
 Summary: The official Python library for the perplexity API
-Project-URL: Homepage, https://github.com/ppl-ai/perplexity-py
-Project-URL: Repository, https://github.com/ppl-ai/perplexity-py
+Project-URL: Homepage, https://github.com/perplexityai/perplexity-py
+Project-URL: Repository, https://github.com/perplexityai/perplexity-py
 Author: Perplexity
 License: Apache-2.0
 Classifier: Intended Audience :: Developers
@@ -46,7 +46,7 @@ It is generated with [Stainless](https://www.stainless.com/).
 
 ## Documentation
 
-The full API of this library can be found in [api.md](https://github.com/ppl-ai/perplexity-py/tree/main/api.md).
+The full API of this library can be found in [api.md](https://github.com/perplexityai/perplexity-py/tree/main/api.md).
 
 ## Installation
 
@@ -96,7 +96,7 @@ for result in content.results:
 
 ## Chat Completions
 
-The full API of this library can be found in [api.md](https://github.com/ppl-ai/perplexity-py/tree/main/api.md).
+The full API of this library can be found in [api.md](https://github.com/perplexityai/perplexity-py/tree/main/api.md).
 
 ```python
 import os
@@ -336,7 +336,7 @@ client.with_options(timeout=5.0).chat.completions.create(
 
 On timeout, an `APITimeoutError` is thrown.
 
-Note that requests that time out are [retried twice by default](https://github.com/ppl-ai/perplexity-py/tree/main/#retries).
+Note that requests that time out are [retried twice by default](https://github.com/perplexityai/perplexity-py/tree/main/#retries).
 
 ## Advanced
 
@@ -385,9 +385,9 @@ completion = response.parse()  # get the object that `chat.completions.create()`
 print(completion.id)
 ```
 
-These methods return an [`APIResponse`](https://github.com/ppl-ai/perplexity-py/tree/main/src/perplexity/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/perplexityai/perplexity-py/tree/main/src/perplexity/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/ppl-ai/perplexity-py/tree/main/src/perplexity/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+The async client returns an [`AsyncAPIResponse`](https://github.com/perplexityai/perplexity-py/tree/main/src/perplexity/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
 
 #### `.with_streaming_response`
 
@@ -499,7 +499,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/ppl-ai/perplexity-py/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/perplexityai/perplexity-py/issues) with questions, bugs, or suggestions.
 
 ### Determining the installed version
 
@@ -518,4 +518,4 @@ Python 3.8 or higher.
 
 ## Contributing
 
-See [the contributing documentation](https://github.com/ppl-ai/perplexity-py/tree/main/./CONTRIBUTING.md).
+See [the contributing documentation](https://github.com/perplexityai/perplexity-py/tree/main/./CONTRIBUTING.md).

{perplexityai-0.10.0.dist-info → perplexityai-0.12.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
-perplexity/__init__.py,sha256=5epbvK3UiJEgvsBW9Ds6RFB6zObkUxYkA9fIQlgUaXA,2655
-perplexity/_base_client.py,sha256=DSeMteXutziRGJA9HqJaoLpG7ktzpU2GPcaIgQT1oZQ,67051
-perplexity/_client.py,sha256=ugPHT0ZV5WX9iHSej604Nj3WEIQkm2z2rUiARPbX_UU,16078
+perplexity/__init__.py,sha256=tK4KC0qHjpk-ym2IM9lG56HeBXAHz36gMzb0rmWEa7Y,2701
+perplexity/_base_client.py,sha256=aOipaCx-xU9FMpoqKMCzs6LHxmeGlLUlGiihUUNLGUc,67051
+perplexity/_client.py,sha256=9YI3kl7PYP8tBT2R_rgi9u5OIBkDqDO0IwY-oDLB-QA,16063
 perplexity/_compat.py,sha256=DQBVORjFb33zch24jzkhM14msvnzY7mmSmgDLaVFUM8,6562
 perplexity/_constants.py,sha256=S14PFzyN9-I31wiV7SmIlL5Ga0MLHxdvegInGdXH7tM,462
 perplexity/_exceptions.py,sha256=v-hOXWSDTEtXcn_By7pPml3HjEmG5HXpbE-RK_A6_0Q,3228
 perplexity/_files.py,sha256=KnEzGi_O756MvKyJ4fOCW_u3JhOeWPQ4RsmDvqihDQU,3545
 perplexity/_models.py,sha256=lKnskYPONAWDvWo8tmbbVk7HmG7UOsI0Nve0vSMmkRc,30452
-perplexity/_qs.py,sha256=AOkSz4rHtK4YI3ZU_kzea-zpwBUgEY8WniGmTPyEimc,4846
+perplexity/_qs.py,sha256=craIKyvPktJ94cvf9zn8j8ekG9dWJzhWv0ob34lIOv4,4828
 perplexity/_resource.py,sha256=Pgc8KNBsIc1ltJn94uhDcDl0-3n5RLbe3iC2AiiNRnE,1124
 perplexity/_response.py,sha256=bpqzmVGq6jnivoMkUgt3OI0Rh6xHd6BMcp5PHgSFPb0,28842
 perplexity/_streaming.py,sha256=SQ61v42gFmNiO57uMFUZMAuDlGE0n_EulkZcPgJXt4U,10116
-perplexity/_types.py,sha256=XZYv2_G7oQGhQkjI28-TFIMP_yZZV590TRuKAoLJ3wM,7300
-perplexity/_version.py,sha256=wMd_e_2KT2gFMBL3gf_yIjVRS3s3vm2EgP5KIx529P4,163
+perplexity/_types.py,sha256=BPuUCddonHjZ2AeEModCeb-zAYCRRT5XtxneIQhJxAk,7240
+perplexity/_version.py,sha256=_Qos24ldDIwii05zOluYsLPQqaaUym8lHaQWjOY80Q4,163
 perplexity/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 perplexity/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 perplexity/_utils/_compat.py,sha256=D8gtAvjJQrDWt9upS0XaG9Rr5l1QhiAx_I_1utT_tt0,1195
@@ -22,22 +22,22 @@ perplexity/_utils/_reflection.py,sha256=ZmGkIgT_PuwedyNBrrKGbxoWtkpytJNU1uU4QHnm
 perplexity/_utils/_resources_proxy.py,sha256=iMCHPeYmXwSunawEq3fcKGszOF3kL9w1ob-48Xnl04I,609
 perplexity/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-noMLM,289
 perplexity/_utils/_sync.py,sha256=TpGLrrhRNWTJtODNE6Fup3_k7zrWm1j2RlirzBwre-0,2862
-perplexity/_utils/_transform.py,sha256=i_U4R82RtQJtKKCriwFqmfcWjtwmmsiiF1AEXKQ_OPo,15957
+perplexity/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3ur9mcNF-E,15951
 perplexity/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
-perplexity/_utils/_utils.py,sha256=D2QE7mVPNEJzaB50u8rvDQAUDS5jx7JoeFD7zdj-TeI,12231
+perplexity/_utils/_utils.py,sha256=0dDqauUbVZEXV0NVl7Bwu904Wwo5eyFCZpQThhFNhyA,12253
 perplexity/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 perplexity/resources/__init__.py,sha256=Tb4UViVZDl2k8DgP1lKfn08Qaqz1uiezsogWRW9YTfQ,1414
-perplexity/resources/search.py,sha256=YQzdtA6ZsD9DPI4PXVkxSh1HlampxiI-epd9O7dNrGo,7010
+perplexity/resources/search.py,sha256=M72I8ZPJ_KxGwgn7FDm3kdvvRqeiFgps_Bce-AdGm8E,7146
 perplexity/resources/async_/__init__.py,sha256=hvcoEKx4nCYPDoBSO_sk-uNVQ7y-fmNhzvAlvX19TIo,964
-perplexity/resources/async_/async_.py,sha256=p1-C_8m2cdS0NR3oa7FfdM8gxHH13LQWX6c9lh1gnFo,3510
+perplexity/resources/async_/async_.py,sha256=XzvC3AMbXXQ9mqe9TI10ZSmEuXaWPRwNC4E7AjvNdg0,3534
 perplexity/resources/async_/chat/__init__.py,sha256=BVAfz9TM3DT5W9f_mt0P9YRxL_MsUxKCWAH6u1iogmA,1041
-perplexity/resources/async_/chat/chat.py,sha256=wOHHfLclvjAVv-btASi6EcdY5gJZQdwAdbR9Q9H4BKw,3658
-perplexity/resources/async_/chat/completions.py,sha256=VGYNp5B-WSLgGRHlNJ1V4qkH-6s_pTZbw0ENGtFK9W0,14097
+perplexity/resources/async_/chat/chat.py,sha256=M3hN3sfZKAt1C8FhOaWtxFPJAmPyE-GXkiU_LSN9EiA,3682
+perplexity/resources/async_/chat/completions.py,sha256=xAhxfRXduWZy3JdCSLX7eTStd_rG55qsGqmsDqFI3gM,14007
 perplexity/resources/chat/__init__.py,sha256=BVAfz9TM3DT5W9f_mt0P9YRxL_MsUxKCWAH6u1iogmA,1041
-perplexity/resources/chat/chat.py,sha256=P143HQo1m9MknnYtSq4JzmDofDtGHlXHzTaLEyr1a7k,3656
-perplexity/resources/chat/completions.py,sha256=tHOAzaktVNOaQBZCMgdz3sgdyguy2l7UOGENLj3k7iQ,19675
+perplexity/resources/chat/chat.py,sha256=yvQmxxpr7k9-A8UwUukL5QIXHahfsdFjHQqRFWWbkzE,3680
+perplexity/resources/chat/completions.py,sha256=d70koq7kxMMMOsL4d7qNLz-meR35l4d2i-DIqKZl3no,18775
 perplexity/types/__init__.py,sha256=ZONTqk9Xtih2BkldS3hQyCK5fO6dsUpMct8WUDCvBq0,491
-perplexity/types/search_create_params.py,sha256=TENCoRI6XQhag-593m5qIsT_vHZYhuX4LLtCZnFgjE0,528
+perplexity/types/search_create_params.py,sha256=5cc01O0upHO7-dZrIHEi3KKhFYlCANUlhRSty4jQpHc,556
 perplexity/types/search_create_response.py,sha256=lOteaJs4qpULkx5GLtEs6HhetqIBhM0I1AC1moWTeI8,426
 perplexity/types/async_/__init__.py,sha256=OKfJYcKb4NObdiRObqJV_dOyDQ8feXekDUge2o_4pXQ,122
 perplexity/types/async_/chat/__init__.py,sha256=xo2Cya_CfjEBRos2yvW_Wrq39PZiXFBT7ukZZBNvIUM,552
@@ -58,7 +58,7 @@ perplexity/types/shared/usage_info.py,sha256=_jE7Nal9cMxtEpJjT4t2SAs6z3MufrjwPug
 perplexity/types/shared_params/__init__.py,sha256=v5gr6-wq7IWgrQ8un401oApylzh3KnsIF_ilz-roX0s,241
 perplexity/types/shared_params/api_public_search_result.py,sha256=n4VUQnGOFGGWUdwYd8P5o-vEqZKhRuI5R0dBs_ZsHtE,418
 perplexity/types/shared_params/chat_message_input.py,sha256=BsNwhjwOFydvUo2OfrF9AHx--a1uPidSxdDyBGrK-sc,6690
-perplexityai-0.10.0.dist-info/METADATA,sha256=0YEPDZyoJVPUqJ1FRpzED5J6Is7lAIDQY3eckvSUx38,15981
-perplexityai-0.10.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-perplexityai-0.10.0.dist-info/licenses/LICENSE,sha256=hkCriG3MT4vBhhc0roAOsrCE7IEDr1ywVEMonVHGmAQ,11340
-perplexityai-0.10.0.dist-info/RECORD,,
+perplexityai-0.12.0.dist-info/METADATA,sha256=5UT7w2B6X6dI1nJpLnPCdVknnhXEF35M02YN64iJMi4,16035
+perplexityai-0.12.0.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+perplexityai-0.12.0.dist-info/licenses/LICENSE,sha256=hkCriG3MT4vBhhc0roAOsrCE7IEDr1ywVEMonVHGmAQ,11340
+perplexityai-0.12.0.dist-info/RECORD,,