chore(api): mark some methods as deprecated

Author: stainless-app[bot]

src/codex/resources/projects/entries.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import typing_extensions
 from typing import Iterable, Optional
 
 import httpx
@@ -312,6 +313,7 @@ def publish_draft_answer(
             cast_to=Entry,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def query(
         self,
         project_id: str,
@@ -707,6 +709,7 @@ async def publish_draft_answer(
             cast_to=Entry,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def query(
         self,
         project_id: str,
@@ -839,8 +842,10 @@ def __init__(self, entries: EntriesResource) -> None:
         self.publish_draft_answer = to_raw_response_wrapper(
             entries.publish_draft_answer,
         )
-        self.query = to_raw_response_wrapper(
-            entries.query,
+        self.query = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                entries.query  # pyright: ignore[reportDeprecated],
+            )
         )
         self.unpublish_answer = to_raw_response_wrapper(
             entries.unpublish_answer,
@@ -869,8 +874,10 @@ def __init__(self, entries: AsyncEntriesResource) -> None:
         self.publish_draft_answer = async_to_raw_response_wrapper(
             entries.publish_draft_answer,
         )
-        self.query = async_to_raw_response_wrapper(
-            entries.query,
+        self.query = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                entries.query  # pyright: ignore[reportDeprecated],
+            )
         )
         self.unpublish_answer = async_to_raw_response_wrapper(
             entries.unpublish_answer,
@@ -899,8 +906,10 @@ def __init__(self, entries: EntriesResource) -> None:
         self.publish_draft_answer = to_streamed_response_wrapper(
             entries.publish_draft_answer,
         )
-        self.query = to_streamed_response_wrapper(
-            entries.query,
+        self.query = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                entries.query  # pyright: ignore[reportDeprecated],
+            )
         )
         self.unpublish_answer = to_streamed_response_wrapper(
             entries.unpublish_answer,
@@ -929,8 +938,10 @@ def __init__(self, entries: AsyncEntriesResource) -> None:
         self.publish_draft_answer = async_to_streamed_response_wrapper(
             entries.publish_draft_answer,
         )
-        self.query = async_to_streamed_response_wrapper(
-            entries.query,
+        self.query = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                entries.query  # pyright: ignore[reportDeprecated],
+            )
         )
         self.unpublish_answer = async_to_streamed_response_wrapper(
             entries.unpublish_answer,

src/codex/resources/projects/projects.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import typing_extensions
 from typing import Dict, List, Optional
 from typing_extensions import Literal
 
@@ -330,6 +331,7 @@ def export(
             cast_to=object,
         )
 
+    @typing_extensions.deprecated("deprecated")
     def increment_queries(
         self,
         project_id: str,
@@ -872,6 +874,7 @@ async def export(
             cast_to=object,
         )
 
+    @typing_extensions.deprecated("deprecated")
     async def increment_queries(
         self,
         project_id: str,
@@ -1167,8 +1170,10 @@ def __init__(self, projects: ProjectsResource) -> None:
         self.export = to_raw_response_wrapper(
             projects.export,
         )
-        self.increment_queries = to_raw_response_wrapper(
-            projects.increment_queries,
+        self.increment_queries = (  # pyright: ignore[reportDeprecated]
+            to_raw_response_wrapper(
+                projects.increment_queries  # pyright: ignore[reportDeprecated],
+            )
         )
         self.retrieve_analytics = to_raw_response_wrapper(
             projects.retrieve_analytics,
@@ -1212,8 +1217,10 @@ def __init__(self, projects: AsyncProjectsResource) -> None:
         self.export = async_to_raw_response_wrapper(
             projects.export,
         )
-        self.increment_queries = async_to_raw_response_wrapper(
-            projects.increment_queries,
+        self.increment_queries = (  # pyright: ignore[reportDeprecated]
+            async_to_raw_response_wrapper(
+                projects.increment_queries  # pyright: ignore[reportDeprecated],
+            )
         )
         self.retrieve_analytics = async_to_raw_response_wrapper(
             projects.retrieve_analytics,
@@ -1257,8 +1264,10 @@ def __init__(self, projects: ProjectsResource) -> None:
         self.export = to_streamed_response_wrapper(
             projects.export,
         )
-        self.increment_queries = to_streamed_response_wrapper(
-            projects.increment_queries,
+        self.increment_queries = (  # pyright: ignore[reportDeprecated]
+            to_streamed_response_wrapper(
+                projects.increment_queries  # pyright: ignore[reportDeprecated],
+            )
         )
         self.retrieve_analytics = to_streamed_response_wrapper(
             projects.retrieve_analytics,
@@ -1302,8 +1311,10 @@ def __init__(self, projects: AsyncProjectsResource) -> None:
         self.export = async_to_streamed_response_wrapper(
             projects.export,
         )
-        self.increment_queries = async_to_streamed_response_wrapper(
-            projects.increment_queries,
+        self.increment_queries = (  # pyright: ignore[reportDeprecated]
+            async_to_streamed_response_wrapper(
+                projects.increment_queries  # pyright: ignore[reportDeprecated],
+            )
         )
         self.retrieve_analytics = async_to_streamed_response_wrapper(
             projects.retrieve_analytics,

tests/api_resources/projects/test_entries.py

@@ -15,6 +15,8 @@
     EntryNotifySmeResponse,
 )
 
+# pyright: reportDeprecated=false
+
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
 
@@ -382,40 +384,45 @@ def test_path_params_publish_draft_answer(self, client: Codex) -> None:
     @pytest.mark.skip()
     @parametrize
     def test_method_query(self, client: Codex) -> None:
-        entry = client.projects.entries.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        )
+        with pytest.warns(DeprecationWarning):
+            entry = client.projects.entries.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            )
+
         assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
     @pytest.mark.skip()
     @parametrize
     def test_method_query_with_all_params(self, client: Codex) -> None:
-        entry = client.projects.entries.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-            use_llm_matching=True,
-            client_metadata={},
-            query_metadata={
-                "context": "string",
-                "custom_metadata": {},
-                "eval_scores": {"foo": 0},
-                "evaluated_response": "evaluated_response",
-            },
-            x_client_library_version="x-client-library-version",
-            x_integration_type="x-integration-type",
-            x_source="x-source",
-            x_stainless_package_version="x-stainless-package-version",
-        )
+        with pytest.warns(DeprecationWarning):
+            entry = client.projects.entries.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+                use_llm_matching=True,
+                client_metadata={},
+                query_metadata={
+                    "context": "string",
+                    "custom_metadata": {},
+                    "eval_scores": {"foo": 0},
+                    "evaluated_response": "evaluated_response",
+                },
+                x_client_library_version="x-client-library-version",
+                x_integration_type="x-integration-type",
+                x_source="x-source",
+                x_stainless_package_version="x-stainless-package-version",
+            )
+
         assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
     @pytest.mark.skip()
     @parametrize
     def test_raw_response_query(self, client: Codex) -> None:
-        response = client.projects.entries.with_raw_response.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        )
+        with pytest.warns(DeprecationWarning):
+            response = client.projects.entries.with_raw_response.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -425,26 +432,28 @@ def test_raw_response_query(self, client: Codex) -> None:
     @pytest.mark.skip()
     @parametrize
     def test_streaming_response_query(self, client: Codex) -> None:
-        with client.projects.entries.with_streaming_response.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with pytest.warns(DeprecationWarning):
+            with client.projects.entries.with_streaming_response.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-            entry = response.parse()
-            assert_matches_type(EntryQueryResponse, entry, path=["response"])
+                entry = response.parse()
+                assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
     @pytest.mark.skip()
     @parametrize
     def test_path_params_query(self, client: Codex) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `project_id` but received ''"):
-            client.projects.entries.with_raw_response.query(
-                project_id="",
-                question="question",
-            )
+        with pytest.warns(DeprecationWarning):
+            with pytest.raises(ValueError, match=r"Expected a non-empty value for `project_id` but received ''"):
+                client.projects.entries.with_raw_response.query(
+                    project_id="",
+                    question="question",
+                )
 
     @pytest.mark.skip()
     @parametrize
@@ -863,40 +872,45 @@ async def test_path_params_publish_draft_answer(self, async_client: AsyncCodex)
     @pytest.mark.skip()
     @parametrize
     async def test_method_query(self, async_client: AsyncCodex) -> None:
-        entry = await async_client.projects.entries.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        )
+        with pytest.warns(DeprecationWarning):
+            entry = await async_client.projects.entries.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            )
+
         assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
     @pytest.mark.skip()
     @parametrize
     async def test_method_query_with_all_params(self, async_client: AsyncCodex) -> None:
-        entry = await async_client.projects.entries.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-            use_llm_matching=True,
-            client_metadata={},
-            query_metadata={
-                "context": "string",
-                "custom_metadata": {},
-                "eval_scores": {"foo": 0},
-                "evaluated_response": "evaluated_response",
-            },
-            x_client_library_version="x-client-library-version",
-            x_integration_type="x-integration-type",
-            x_source="x-source",
-            x_stainless_package_version="x-stainless-package-version",
-        )
+        with pytest.warns(DeprecationWarning):
+            entry = await async_client.projects.entries.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+                use_llm_matching=True,
+                client_metadata={},
+                query_metadata={
+                    "context": "string",
+                    "custom_metadata": {},
+                    "eval_scores": {"foo": 0},
+                    "evaluated_response": "evaluated_response",
+                },
+                x_client_library_version="x-client-library-version",
+                x_integration_type="x-integration-type",
+                x_source="x-source",
+                x_stainless_package_version="x-stainless-package-version",
+            )
+
         assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
     @pytest.mark.skip()
     @parametrize
     async def test_raw_response_query(self, async_client: AsyncCodex) -> None:
-        response = await async_client.projects.entries.with_raw_response.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        )
+        with pytest.warns(DeprecationWarning):
+            response = await async_client.projects.entries.with_raw_response.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -906,26 +920,28 @@ async def test_raw_response_query(self, async_client: AsyncCodex) -> None:
     @pytest.mark.skip()
     @parametrize
     async def test_streaming_response_query(self, async_client: AsyncCodex) -> None:
-        async with async_client.projects.entries.with_streaming_response.query(
-            project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
-            question="question",
-        ) as response:
-            assert not response.is_closed
-            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with pytest.warns(DeprecationWarning):
+            async with async_client.projects.entries.with_streaming_response.query(
+                project_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+                question="question",
+            ) as response:
+                assert not response.is_closed
+                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-            entry = await response.parse()
-            assert_matches_type(EntryQueryResponse, entry, path=["response"])
+                entry = await response.parse()
+                assert_matches_type(EntryQueryResponse, entry, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
     @pytest.mark.skip()
     @parametrize
     async def test_path_params_query(self, async_client: AsyncCodex) -> None:
-        with pytest.raises(ValueError, match=r"Expected a non-empty value for `project_id` but received ''"):
-            await async_client.projects.entries.with_raw_response.query(
-                project_id="",
-                question="question",
-            )
+        with pytest.warns(DeprecationWarning):
+            with pytest.raises(ValueError, match=r"Expected a non-empty value for `project_id` but received ''"):
+                await async_client.projects.entries.with_raw_response.query(
+                    project_id="",
+                    question="question",
+                )
 
     @pytest.mark.skip()
     @parametrize