feat(api): update from perform -> create

Author: stainless-app[bot]

.github/workflows/publish-pypi.yml

@@ -1,6 +1,6 @@
 # This workflow is triggered when a GitHub release is created.
 # It can also be run manually to re-publish to PyPI in case it failed for some reason.
-# You can run this workflow by navigating to https://www.github.com/ppl-ai/testing-stainless/actions/workflows/publish-pypi.yml
+# You can run this workflow by navigating to https://www.github.com/ppl-ai/perplexity-py/actions/workflows/publish-pypi.yml
 name: Publish PyPI
 on:
   workflow_dispatch:

.github/workflows/release-doctor.yml

@@ -9,7 +9,7 @@ jobs:
   release_doctor:
     name: release doctor
     runs-on: ubuntu-latest
-    if: github.repository == 'ppl-ai/testing-stainless' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
+    if: github.repository == 'ppl-ai/perplexity-py' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
       - uses: actions/checkout@v4

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 1
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/perplexity-ai%2Fperplexity-0215ad03799c0d48a897533cf7797fc279ca4ddd6ff3ef89194e8637c83d16f0.yml
 openapi_spec_hash: 185af16df97b1856cddb649ceb87fb0d
-config_hash: 1e977530930da048f3a2860a609a6f72
+config_hash: 0949c9a4b53524761966b36d96211b28

CONTRIBUTING.md

@@ -62,7 +62,7 @@ If you’d like to use the repository from source, you can either install from g
 To install via git:
 
 ```sh
-$ pip install git+ssh://[email protected]/ppl-ai/testing-stainless.git
+$ pip install git+ssh://[email protected]/ppl-ai/perplexity-py.git
 ```
 
 Alternatively, you can build from source and install the wheel file:
@@ -120,7 +120,7 @@ the changes aren't made through the automated pipeline, you may want to make rel
 
 ### Publish with a GitHub workflow
 
-You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/ppl-ai/testing-stainless/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
+You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/ppl-ai/perplexity-py/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
 
 ### Publish manually
 

README.md

@@ -32,10 +32,10 @@ client = Perplexity(
     bearer_token=os.environ.get("PERPLEXITY_API_KEY"),  # This is the default and can be omitted
 )
 
-response = client.search.perform(
+search = client.search.create(
     query="string",
 )
-print(response.id)
+print(search.id)
 ```
 
 While you can provide a `bearer_token` keyword argument,
@@ -58,10 +58,10 @@ client = AsyncPerplexity(
 
 
 async def main() -> None:
-    response = await client.search.perform(
+    search = await client.search.create(
         query="string",
     )
-    print(response.id)
+    print(search.id)
 
 
 asyncio.run(main())
@@ -93,10 +93,10 @@ async def main() -> None:
         bearer_token="My Bearer Token",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        response = await client.search.perform(
+        search = await client.search.create(
             query="string",
         )
-        print(response.id)
+        print(search.id)
 
 
 asyncio.run(main())
@@ -127,7 +127,7 @@ from perplexity import Perplexity
 client = Perplexity()
 
 try:
-    client.search.perform(
+    client.search.create(
         query="string",
     )
 except perplexity.APIConnectionError as e:
@@ -172,7 +172,7 @@ client = Perplexity(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).search.perform(
+client.with_options(max_retries=5).search.create(
     query="string",
 )
 ```
@@ -197,7 +197,7 @@ client = Perplexity(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).search.perform(
+client.with_options(timeout=5.0).search.create(
     query="string",
 )
 ```
@@ -240,18 +240,18 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from perplexity import Perplexity
 
 client = Perplexity()
-response = client.search.with_raw_response.perform(
+response = client.search.with_raw_response.create(
     query="string",
 )
 print(response.headers.get('X-My-Header'))
 
-search = response.parse()  # get the object that `search.perform()` would have returned
+search = response.parse()  # get the object that `search.create()` would have returned
 print(search.id)
 ```
 
-These methods return an [`APIResponse`](https://github.com/ppl-ai/testing-stainless/tree/main/src/perplexity/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/ppl-ai/perplexity-py/tree/main/src/perplexity/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/ppl-ai/testing-stainless/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/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.
 
 #### `.with_streaming_response`
 
@@ -260,7 +260,7 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.search.with_streaming_response.perform(
+with client.search.with_streaming_response.create(
     query="string",
 ) as response:
     print(response.headers.get("X-My-Header"))
@@ -357,7 +357,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/testing-stainless/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/ppl-ai/perplexity-py/issues) with questions, bugs, or suggestions.
 
 ### Determining the installed version
 

api.md

@@ -3,9 +3,9 @@
 Types:
 
 ```python
-from perplexity.types import SearchPerformResponse
+from perplexity.types import SearchCreateResponse
 ```
 
 Methods:
 
-- <code title="post /search">client.search.<a href="./src/perplexity/resources/search.py">perform</a>(\*\*<a href="src/perplexity/types/search_perform_params.py">params</a>) -> <a href="./src/perplexity/types/search_perform_response.py">SearchPerformResponse</a></code>
+- <code title="post /search">client.search.<a href="./src/perplexity/resources/search.py">create</a>(\*\*<a href="src/perplexity/types/search_create_params.py">params</a>) -> <a href="./src/perplexity/types/search_create_response.py">SearchCreateResponse</a></code>

pyproject.toml

@@ -35,8 +35,8 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/ppl-ai/testing-stainless"
-Repository = "https://github.com/ppl-ai/testing-stainless"
+Homepage = "https://github.com/ppl-ai/perplexity-py"
+Repository = "https://github.com/ppl-ai/perplexity-py"
 
 [project.optional-dependencies]
 aiohttp = ["aiohttp", "httpx_aiohttp>=0.1.8"]
@@ -124,7 +124,7 @@ path = "README.md"
 [[tool.hatch.metadata.hooks.fancy-pypi-readme.substitutions]]
 # replace relative links with absolute links
 pattern = '\[(.+?)\]\(((?!https?://)\S+?)\)'
-replacement = '[\1](https://github.com/ppl-ai/testing-stainless/tree/main/\g<2>)'
+replacement = '[\1](https://github.com/ppl-ai/perplexity-py/tree/main/\g<2>)'
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

src/perplexity/resources/search.py

@@ -7,7 +7,7 @@
 
 import httpx
 
-from ..types import search_perform_params
+from ..types import search_create_params
 from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
@@ -19,7 +19,7 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
-from ..types.search_perform_response import SearchPerformResponse
+from ..types.search_create_response import SearchCreateResponse
 
 __all__ = ["SearchResource", "AsyncSearchResource"]
 
@@ -31,7 +31,7 @@ def with_raw_response(self) -> SearchResourceWithRawResponse:
         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/testing-stainless#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return SearchResourceWithRawResponse(self)
 
@@ -40,11 +40,11 @@ def with_streaming_response(self) -> SearchResourceWithStreamingResponse:
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/testing-stainless#with_streaming_response
+        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
         """
         return SearchResourceWithStreamingResponse(self)
 
-    def perform(
+    def create(
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
@@ -65,7 +65,7 @@ def perform(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> SearchPerformResponse:
+    ) -> SearchCreateResponse:
         """
         Search
 
@@ -95,12 +95,12 @@ def perform(
                     "search_mode": search_mode,
                     "search_recency_filter": search_recency_filter,
                 },
-                search_perform_params.SearchPerformParams,
+                search_create_params.SearchCreateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=SearchPerformResponse,
+            cast_to=SearchCreateResponse,
         )
 
 
@@ -111,7 +111,7 @@ def with_raw_response(self) -> AsyncSearchResourceWithRawResponse:
         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/testing-stainless#accessing-raw-response-data-eg-headers
+        For more information, see https://www.github.com/ppl-ai/perplexity-py#accessing-raw-response-data-eg-headers
         """
         return AsyncSearchResourceWithRawResponse(self)
 
@@ -120,11 +120,11 @@ def with_streaming_response(self) -> AsyncSearchResourceWithStreamingResponse:
         """
         An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-        For more information, see https://www.github.com/ppl-ai/testing-stainless#with_streaming_response
+        For more information, see https://www.github.com/ppl-ai/perplexity-py#with_streaming_response
         """
         return AsyncSearchResourceWithStreamingResponse(self)
 
-    async def perform(
+    async def create(
         self,
         *,
         query: Union[str, SequenceNotStr[str]],
@@ -145,7 +145,7 @@ async def perform(
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> SearchPerformResponse:
+    ) -> SearchCreateResponse:
         """
         Search
 
@@ -175,46 +175,46 @@ async def perform(
                     "search_mode": search_mode,
                     "search_recency_filter": search_recency_filter,
                 },
-                search_perform_params.SearchPerformParams,
+                search_create_params.SearchCreateParams,
             ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=SearchPerformResponse,
+            cast_to=SearchCreateResponse,
         )
 
 
 class SearchResourceWithRawResponse:
     def __init__(self, search: SearchResource) -> None:
         self._search = search
 
-        self.perform = to_raw_response_wrapper(
-            search.perform,
+        self.create = to_raw_response_wrapper(
+            search.create,
         )
 
 
 class AsyncSearchResourceWithRawResponse:
     def __init__(self, search: AsyncSearchResource) -> None:
         self._search = search
 
-        self.perform = async_to_raw_response_wrapper(
-            search.perform,
+        self.create = async_to_raw_response_wrapper(
+            search.create,
         )
 
 
 class SearchResourceWithStreamingResponse:
     def __init__(self, search: SearchResource) -> None:
         self._search = search
 
-        self.perform = to_streamed_response_wrapper(
-            search.perform,
+        self.create = to_streamed_response_wrapper(
+            search.create,
         )
 
 
 class AsyncSearchResourceWithStreamingResponse:
     def __init__(self, search: AsyncSearchResource) -> None:
         self._search = search
 
-        self.perform = async_to_streamed_response_wrapper(
-            search.perform,
+        self.create = async_to_streamed_response_wrapper(
+            search.create,
         )

src/perplexity/types/__init__.py

@@ -2,5 +2,5 @@
 
 from __future__ import annotations
 
-from .search_perform_params import SearchPerformParams as SearchPerformParams
-from .search_perform_response import SearchPerformResponse as SearchPerformResponse
+from .search_create_params import SearchCreateParams as SearchCreateParams
+from .search_create_response import SearchCreateResponse as SearchCreateResponse

src/perplexity/types/search_perform_params.py renamed to src/perplexity/types/search_create_params.py

@@ -7,10 +7,10 @@
 
 from .._types import SequenceNotStr
 
-__all__ = ["SearchPerformParams"]
+__all__ = ["SearchCreateParams"]
 
 
-class SearchPerformParams(TypedDict, total=False):
+class SearchCreateParams(TypedDict, total=False):
     query: Required[Union[str, SequenceNotStr[str]]]
 
     country: Optional[str]