fix(cloud): use PATCH /cloud/v1/projects

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 640
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-4b7fbbd83aa47dd18d0cfe4f58c2e0394926d5d42c6d44253ffc2e37014da93a.yml
 openapi_spec_hash: 7b964677a4d29ed874df07b3f14f74f6
-config_hash: ac70ccdbdb0bdc6b94d25b9d561d553f
+config_hash: ef6fa8ea607ea31853ae3f4ff506ac7e

api.md

@@ -67,7 +67,7 @@ from gcore.types.cloud import Project
 Methods:
 
 - <code title="post /cloud/v1/projects">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">create</a>(\*\*<a href="src/gcore/types/cloud/project_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/project.py">Project</a></code>
-- <code title="put /cloud/v1/projects/{project_id}">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">update</a>(\*, project_id, \*\*<a href="src/gcore/types/cloud/project_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/project.py">Project</a></code>
+- <code title="patch /cloud/v1/projects/{project_id}">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">update</a>(\*, project_id, \*\*<a href="src/gcore/types/cloud/project_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/project.py">Project</a></code>
 - <code title="get /cloud/v1/projects">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">list</a>(\*\*<a href="src/gcore/types/cloud/project_list_params.py">params</a>) -> <a href="./src/gcore/types/cloud/project.py">SyncOffsetPage[Project]</a></code>
 - <code title="delete /cloud/v1/projects/{project_id}">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">delete</a>(\*, project_id) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
 - <code title="get /cloud/v1/projects/{project_id}">client.cloud.projects.<a href="./src/gcore/resources/cloud/projects.py">get</a>(\*, project_id) -> <a href="./src/gcore/types/cloud/project.py">Project</a></code>

src/gcore/resources/cloud/projects.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import typing_extensions
 from typing import Optional
 from typing_extensions import Literal
 
@@ -92,32 +91,31 @@ def create(
             cast_to=Project,
         )
 
-    @typing_extensions.deprecated("deprecated")
     def update(
         self,
         *,
         project_id: int | None = None,
-        name: str,
-        description: Optional[str] | Omit = omit,
+        description: str | Omit = omit,
+        name: 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,
     ) -> Project:
-        """Update project.
-
-        Depricated: Use PATCH /v1/projects/{project_id} instead Update
-        project name and description.
+        """
+        This endpoint allows partial updates of a project (such as its name or
+        description). Only the fields explicitly provided in the request body will be
+        updated.
 
         Args:
           project_id: Project ID
 
-          name: Name of the entity, following a specific format.
-
           description: Description of the project.
 
+          name: Name of the entity, following a specific format.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -128,12 +126,12 @@ def update(
         """
         if project_id is None:
             project_id = self._client._get_cloud_project_id_path_param()
-        return self._put(
+        return self._patch(
             f"/cloud/v1/projects/{project_id}",
             body=maybe_transform(
                 {
-                    "name": name,
                     "description": description,
+                    "name": name,
                 },
                 project_update_params.ProjectUpdateParams,
             ),
@@ -348,32 +346,31 @@ async def create(
             cast_to=Project,
         )
 
-    @typing_extensions.deprecated("deprecated")
     async def update(
         self,
         *,
         project_id: int | None = None,
-        name: str,
-        description: Optional[str] | Omit = omit,
+        description: str | Omit = omit,
+        name: 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,
     ) -> Project:
-        """Update project.
-
-        Depricated: Use PATCH /v1/projects/{project_id} instead Update
-        project name and description.
+        """
+        This endpoint allows partial updates of a project (such as its name or
+        description). Only the fields explicitly provided in the request body will be
+        updated.
 
         Args:
           project_id: Project ID
 
-          name: Name of the entity, following a specific format.
-
           description: Description of the project.
 
+          name: Name of the entity, following a specific format.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -384,12 +381,12 @@ async def update(
         """
         if project_id is None:
             project_id = self._client._get_cloud_project_id_path_param()
-        return await self._put(
+        return await self._patch(
             f"/cloud/v1/projects/{project_id}",
             body=await async_maybe_transform(
                 {
-                    "name": name,
                     "description": description,
+                    "name": name,
                 },
                 project_update_params.ProjectUpdateParams,
             ),
@@ -546,10 +543,8 @@ def __init__(self, projects: ProjectsResource) -> None:
         self.create = to_raw_response_wrapper(
             projects.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            to_raw_response_wrapper(
-                projects.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = to_raw_response_wrapper(
+            projects.update,
         )
         self.list = to_raw_response_wrapper(
             projects.list,
@@ -569,10 +564,8 @@ def __init__(self, projects: AsyncProjectsResource) -> None:
         self.create = async_to_raw_response_wrapper(
             projects.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            async_to_raw_response_wrapper(
-                projects.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = async_to_raw_response_wrapper(
+            projects.update,
         )
         self.list = async_to_raw_response_wrapper(
             projects.list,
@@ -592,10 +585,8 @@ def __init__(self, projects: ProjectsResource) -> None:
         self.create = to_streamed_response_wrapper(
             projects.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            to_streamed_response_wrapper(
-                projects.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = to_streamed_response_wrapper(
+            projects.update,
         )
         self.list = to_streamed_response_wrapper(
             projects.list,
@@ -615,10 +606,8 @@ def __init__(self, projects: AsyncProjectsResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             projects.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            async_to_streamed_response_wrapper(
-                projects.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = async_to_streamed_response_wrapper(
+            projects.update,
         )
         self.list = async_to_streamed_response_wrapper(
             projects.list,

src/gcore/types/cloud/project_update_params.py

@@ -2,8 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 __all__ = ["ProjectUpdateParams"]
 
@@ -12,8 +11,8 @@ class ProjectUpdateParams(TypedDict, total=False):
     project_id: int
     """Project ID"""
 
-    name: Required[str]
-    """Name of the entity, following a specific format."""
-
-    description: Optional[str]
+    description: str
     """Description of the project."""
+
+    name: str
+    """Name of the entity, following a specific format."""

tests/api_resources/cloud/test_projects.py

@@ -12,8 +12,6 @@
 from gcore.pagination import SyncOffsetPage, AsyncOffsetPage
 from gcore.types.cloud import Project, TaskIDList
 
-# pyright: reportDeprecated=false
-
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")
 
 
@@ -61,32 +59,25 @@ def test_streaming_response_create(self, client: Gcore) -> None:
 
     @parametrize
     def test_method_update(self, client: Gcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            project = client.cloud.projects.update(
-                project_id=4,
-                name="my-project",
-            )
-
+        project = client.cloud.projects.update(
+            project_id=4,
+        )
         assert_matches_type(Project, project, path=["response"])
 
     @parametrize
     def test_method_update_with_all_params(self, client: Gcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            project = client.cloud.projects.update(
-                project_id=4,
-                name="my-project",
-                description="Project description",
-            )
-
+        project = client.cloud.projects.update(
+            project_id=4,
+            description="Project description",
+            name="my-project",
+        )
         assert_matches_type(Project, project, path=["response"])
 
     @parametrize
     def test_raw_response_update(self, client: Gcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            response = client.cloud.projects.with_raw_response.update(
-                project_id=4,
-                name="my-project",
-            )
+        response = client.cloud.projects.with_raw_response.update(
+            project_id=4,
+        )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -95,16 +86,14 @@ def test_raw_response_update(self, client: Gcore) -> None:
 
     @parametrize
     def test_streaming_response_update(self, client: Gcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            with client.cloud.projects.with_streaming_response.update(
-                project_id=4,
-                name="my-project",
-            ) as response:
-                assert not response.is_closed
-                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        with client.cloud.projects.with_streaming_response.update(
+            project_id=4,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
 
-                project = response.parse()
-                assert_matches_type(Project, project, path=["response"])
+            project = response.parse()
+            assert_matches_type(Project, project, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 
@@ -254,32 +243,25 @@ async def test_streaming_response_create(self, async_client: AsyncGcore) -> None
 
     @parametrize
     async def test_method_update(self, async_client: AsyncGcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            project = await async_client.cloud.projects.update(
-                project_id=4,
-                name="my-project",
-            )
-
+        project = await async_client.cloud.projects.update(
+            project_id=4,
+        )
         assert_matches_type(Project, project, path=["response"])
 
     @parametrize
     async def test_method_update_with_all_params(self, async_client: AsyncGcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            project = await async_client.cloud.projects.update(
-                project_id=4,
-                name="my-project",
-                description="Project description",
-            )
-
+        project = await async_client.cloud.projects.update(
+            project_id=4,
+            description="Project description",
+            name="my-project",
+        )
         assert_matches_type(Project, project, path=["response"])
 
     @parametrize
     async def test_raw_response_update(self, async_client: AsyncGcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            response = await async_client.cloud.projects.with_raw_response.update(
-                project_id=4,
-                name="my-project",
-            )
+        response = await async_client.cloud.projects.with_raw_response.update(
+            project_id=4,
+        )
 
         assert response.is_closed is True
         assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -288,16 +270,14 @@ async def test_raw_response_update(self, async_client: AsyncGcore) -> None:
 
     @parametrize
     async def test_streaming_response_update(self, async_client: AsyncGcore) -> None:
-        with pytest.warns(DeprecationWarning):
-            async with async_client.cloud.projects.with_streaming_response.update(
-                project_id=4,
-                name="my-project",
-            ) as response:
-                assert not response.is_closed
-                assert response.http_request.headers.get("X-Stainless-Lang") == "python"
-
-                project = await response.parse()
-                assert_matches_type(Project, project, path=["response"])
+        async with async_client.cloud.projects.with_streaming_response.update(
+            project_id=4,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            project = await response.parse()
+            assert_matches_type(Project, project, path=["response"])
 
         assert cast(Any, response.is_closed) is True
 

tests/test_client.py

@@ -377,11 +377,11 @@ def test_default_query_option(self) -> None:
     def test_cloud_project_id_client_params(self, client: Gcore) -> None:
         # Test with base client (no custom params)
         with pytest.raises(ValueError, match="Missing cloud_project_id argument;"):
-            client.cloud.projects.update(name="my-project")
+            client.cloud.projects.update()
 
         client = Gcore(base_url=base_url, api_key=api_key, _strict_response_validation=True, cloud_project_id=0)
         with client as c2:
-            c2.cloud.projects.update(name="my-project")
+            c2.cloud.projects.update()
 
     def test_cloud_region_id_client_params(self, client: Gcore) -> None:
         # Test with base client (no custom params)
@@ -1216,11 +1216,11 @@ async def test_default_query_option(self) -> None:
     async def test_cloud_project_id_client_params(self, async_client: AsyncGcore) -> None:
         # Test with base client (no custom params)
         with pytest.raises(ValueError, match="Missing cloud_project_id argument;"):
-            await async_client.cloud.projects.update(name="my-project")
+            await async_client.cloud.projects.update()
 
         client = AsyncGcore(base_url=base_url, api_key=api_key, _strict_response_validation=True, cloud_project_id=0)
         async with client as c2:
-            await c2.cloud.projects.update(name="my-project")
+            await c2.cloud.projects.update()
 
     async def test_cloud_region_id_client_params(self, async_client: AsyncGcore) -> None:
         # Test with base client (no custom params)