feat(api): add better deprecation messages

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 124
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamaindex-Georgehe4%2Fllamacloud-prod-0621942c2d9e350303a5493849418a098661308abeee25edb20fb3ebec5ceb91.yml
 openapi_spec_hash: fd68b148a8436af688ff069966482497
-config_hash: 75d0eba69d885d27ad499a97f0ea52f6
+config_hash: 7dadebf3fd93086145102eca5b571ae5

src/llama_cloud/resources/classifier/jobs.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import typing_extensions
 from typing import Iterable, Optional
 from typing_extensions import Literal
 
@@ -53,6 +54,7 @@ def with_streaming_response(self) -> JobsResourceWithStreamingResponse:
         """
         return JobsResourceWithStreamingResponse(self)
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     def create(
         self,
         *,
@@ -122,6 +124,7 @@ def create(
             cast_to=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     def list(
         self,
         *,
@@ -171,6 +174,7 @@ def list(
             model=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     def get(
         self,
         classify_job_id: str,
@@ -218,6 +222,7 @@ def get(
             cast_to=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     def get_results(
         self,
         classify_job_id: str,
@@ -286,6 +291,7 @@ def with_streaming_response(self) -> AsyncJobsResourceWithStreamingResponse:
         """
         return AsyncJobsResourceWithStreamingResponse(self)
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     async def create(
         self,
         *,
@@ -355,6 +361,7 @@ async def create(
             cast_to=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     def list(
         self,
         *,
@@ -404,6 +411,7 @@ def list(
             model=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     async def get(
         self,
         classify_job_id: str,
@@ -451,6 +459,7 @@ async def get(
             cast_to=ClassifyJob,
         )
 
+    @typing_extensions.deprecated("Please use 'client.classify'")
     async def get_results(
         self,
         classify_job_id: str,
@@ -503,69 +512,101 @@ class JobsResourceWithRawResponse:
     def __init__(self, jobs: JobsResource) -> None:
         self._jobs = jobs
 
-        self.create = to_raw_response_wrapper(
-            jobs.create,
+        self.create = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                jobs.create,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.list = to_raw_response_wrapper(
-            jobs.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                jobs.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = to_raw_response_wrapper(
-            jobs.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                jobs.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_results = to_raw_response_wrapper(
-            jobs.get_results,
+        self.get_results = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                jobs.get_results,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
 class AsyncJobsResourceWithRawResponse:
     def __init__(self, jobs: AsyncJobsResource) -> None:
         self._jobs = jobs
 
-        self.create = async_to_raw_response_wrapper(
-            jobs.create,
+        self.create = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                jobs.create,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.list = async_to_raw_response_wrapper(
-            jobs.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                jobs.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = async_to_raw_response_wrapper(
-            jobs.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                jobs.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_results = async_to_raw_response_wrapper(
-            jobs.get_results,
+        self.get_results = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                jobs.get_results,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
 class JobsResourceWithStreamingResponse:
     def __init__(self, jobs: JobsResource) -> None:
         self._jobs = jobs
 
-        self.create = to_streamed_response_wrapper(
-            jobs.create,
+        self.create = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                jobs.create,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.list = to_streamed_response_wrapper(
-            jobs.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                jobs.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = to_streamed_response_wrapper(
-            jobs.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                jobs.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_results = to_streamed_response_wrapper(
-            jobs.get_results,
+        self.get_results = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                jobs.get_results,  # pyright: ignore[reportDeprecated],
+            )
         )
 
 
 class AsyncJobsResourceWithStreamingResponse:
     def __init__(self, jobs: AsyncJobsResource) -> None:
         self._jobs = jobs
 
-        self.create = async_to_streamed_response_wrapper(
-            jobs.create,
+        self.create = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                jobs.create,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.list = async_to_streamed_response_wrapper(
-            jobs.list,
+        self.list = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                jobs.list,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get = async_to_streamed_response_wrapper(
-            jobs.get,
+        self.get = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                jobs.get,  # pyright: ignore[reportDeprecated],
+            )
         )
-        self.get_results = async_to_streamed_response_wrapper(
-            jobs.get_results,
+        self.get_results = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                jobs.get_results,  # pyright: ignore[reportDeprecated],
+            )
         )