gcore 0.16.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

gcore/resources/cloud/databases/postgres/postgres.py

@@ -0,0 +1,166 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from ....._compat import cached_property
+from ....._resource import SyncAPIResource, AsyncAPIResource
+from .configurations import (
+    ConfigurationsResource,
+    AsyncConfigurationsResource,
+    ConfigurationsResourceWithRawResponse,
+    AsyncConfigurationsResourceWithRawResponse,
+    ConfigurationsResourceWithStreamingResponse,
+    AsyncConfigurationsResourceWithStreamingResponse,
+)
+from .clusters.clusters import (
+    ClustersResource,
+    AsyncClustersResource,
+    ClustersResourceWithRawResponse,
+    AsyncClustersResourceWithRawResponse,
+    ClustersResourceWithStreamingResponse,
+    AsyncClustersResourceWithStreamingResponse,
+)
+from .custom_configurations import (
+    CustomConfigurationsResource,
+    AsyncCustomConfigurationsResource,
+    CustomConfigurationsResourceWithRawResponse,
+    AsyncCustomConfigurationsResourceWithRawResponse,
+    CustomConfigurationsResourceWithStreamingResponse,
+    AsyncCustomConfigurationsResourceWithStreamingResponse,
+)
+
+__all__ = ["PostgresResource", "AsyncPostgresResource"]
+
+
+class PostgresResource(SyncAPIResource):
+    @cached_property
+    def clusters(self) -> ClustersResource:
+        return ClustersResource(self._client)
+
+    @cached_property
+    def configurations(self) -> ConfigurationsResource:
+        return ConfigurationsResource(self._client)
+
+    @cached_property
+    def custom_configurations(self) -> CustomConfigurationsResource:
+        return CustomConfigurationsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> PostgresResourceWithRawResponse:
+        """
+        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/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return PostgresResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> PostgresResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return PostgresResourceWithStreamingResponse(self)
+
+
+class AsyncPostgresResource(AsyncAPIResource):
+    @cached_property
+    def clusters(self) -> AsyncClustersResource:
+        return AsyncClustersResource(self._client)
+
+    @cached_property
+    def configurations(self) -> AsyncConfigurationsResource:
+        return AsyncConfigurationsResource(self._client)
+
+    @cached_property
+    def custom_configurations(self) -> AsyncCustomConfigurationsResource:
+        return AsyncCustomConfigurationsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncPostgresResourceWithRawResponse:
+        """
+        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/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncPostgresResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncPostgresResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
+        """
+        return AsyncPostgresResourceWithStreamingResponse(self)
+
+
+class PostgresResourceWithRawResponse:
+    def __init__(self, postgres: PostgresResource) -> None:
+        self._postgres = postgres
+
+    @cached_property
+    def clusters(self) -> ClustersResourceWithRawResponse:
+        return ClustersResourceWithRawResponse(self._postgres.clusters)
+
+    @cached_property
+    def configurations(self) -> ConfigurationsResourceWithRawResponse:
+        return ConfigurationsResourceWithRawResponse(self._postgres.configurations)
+
+    @cached_property
+    def custom_configurations(self) -> CustomConfigurationsResourceWithRawResponse:
+        return CustomConfigurationsResourceWithRawResponse(self._postgres.custom_configurations)
+
+
+class AsyncPostgresResourceWithRawResponse:
+    def __init__(self, postgres: AsyncPostgresResource) -> None:
+        self._postgres = postgres
+
+    @cached_property
+    def clusters(self) -> AsyncClustersResourceWithRawResponse:
+        return AsyncClustersResourceWithRawResponse(self._postgres.clusters)
+
+    @cached_property
+    def configurations(self) -> AsyncConfigurationsResourceWithRawResponse:
+        return AsyncConfigurationsResourceWithRawResponse(self._postgres.configurations)
+
+    @cached_property
+    def custom_configurations(self) -> AsyncCustomConfigurationsResourceWithRawResponse:
+        return AsyncCustomConfigurationsResourceWithRawResponse(self._postgres.custom_configurations)
+
+
+class PostgresResourceWithStreamingResponse:
+    def __init__(self, postgres: PostgresResource) -> None:
+        self._postgres = postgres
+
+    @cached_property
+    def clusters(self) -> ClustersResourceWithStreamingResponse:
+        return ClustersResourceWithStreamingResponse(self._postgres.clusters)
+
+    @cached_property
+    def configurations(self) -> ConfigurationsResourceWithStreamingResponse:
+        return ConfigurationsResourceWithStreamingResponse(self._postgres.configurations)
+
+    @cached_property
+    def custom_configurations(self) -> CustomConfigurationsResourceWithStreamingResponse:
+        return CustomConfigurationsResourceWithStreamingResponse(self._postgres.custom_configurations)
+
+
+class AsyncPostgresResourceWithStreamingResponse:
+    def __init__(self, postgres: AsyncPostgresResource) -> None:
+        self._postgres = postgres
+
+    @cached_property
+    def clusters(self) -> AsyncClustersResourceWithStreamingResponse:
+        return AsyncClustersResourceWithStreamingResponse(self._postgres.clusters)
+
+    @cached_property
+    def configurations(self) -> AsyncConfigurationsResourceWithStreamingResponse:
+        return AsyncConfigurationsResourceWithStreamingResponse(self._postgres.configurations)
+
+    @cached_property
+    def custom_configurations(self) -> AsyncCustomConfigurationsResourceWithStreamingResponse:
+        return AsyncCustomConfigurationsResourceWithStreamingResponse(self._postgres.custom_configurations)

gcore/resources/cloud/file_shares/file_shares.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import typing_extensions
 from typing import Dict, Iterable, Optional
 from typing_extensions import Literal, overload
 
@@ -106,9 +105,10 @@ class FileSharesResource(SyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           type_name: Standard file share type
 
@@ -162,9 +162,10 @@ class FileSharesResource(SyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           type_name: Vast file share type
 
@@ -228,7 +229,6 @@ class FileSharesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
-    @typing_extensions.deprecated("deprecated")
     def update(
         self,
         file_share_id: str,
@@ -244,12 +244,9 @@ class FileSharesResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileShare:
+    ) -> TaskIDList:
         """
-        Rename file share or update tags
-
-        **Deprecated**: Use PATCH
-        /v3/`file_shares`/{`project_id`}/{`region_id`}/{`file_share_id`} instead
+        Rename file share, update tags or set share specific properties
 
         Args:
           project_id: Project ID
@@ -272,15 +269,20 @@ class FileSharesResource(SyncAPIResource):
               - **Add/update tags:**
                 `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
                 updates existing ones.
-              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
+
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+
               - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
                 tags are preserved).
+
               - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
                 specified tags.
+
               - **Mixed operations:**
-                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
                 adds/updates 'environment' and '`cost_center`' while removing
                 '`deprecated_tag`', preserving other existing tags.
+
               - **Replace all:** first delete existing tags with null values, then add new
                 ones in the same request.
 
@@ -299,7 +301,7 @@ class FileSharesResource(SyncAPIResource):
         if not file_share_id:
             raise ValueError(f"Expected a non-empty value for `file_share_id` but received {file_share_id!r}")
         return self._patch(
-            f"/cloud/v1/file_shares/{project_id}/{region_id}/{file_share_id}",
+            f"/cloud/v3/file_shares/{project_id}/{region_id}/{file_share_id}",
             body=maybe_transform(
                 {
                     "name": name,
@@ -311,7 +313,55 @@ class FileSharesResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=FileShare,
+            cast_to=TaskIDList,
+        )
+
+    def update_and_poll(
+        self,
+        file_share_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str | Omit = omit,
+        share_settings: file_share_update_params.ShareSettings | Omit = omit,
+        tags: Optional[TagUpdateMapParam] | Omit = omit,
+        polling_interval_seconds: int | Omit = omit,
+        polling_timeout_seconds: int | 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,
+    ) -> FileShare:
+        response = self.update(
+            file_share_id,
+            project_id=project_id,
+            region_id=region_id,
+            name=name,
+            share_settings=share_settings,
+            tags=tags,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+            polling_timeout_seconds=polling_timeout_seconds,
+        )
+        return self.get(
+            file_share_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
         )
 
     def list(
@@ -585,9 +635,10 @@ class AsyncFileSharesResource(AsyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           type_name: Standard file share type
 
@@ -641,9 +692,10 @@ class AsyncFileSharesResource(AsyncAPIResource):
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
-              better organization and management. Some tags are read-only and cannot be
-              modified by the user. Tags are also integrated with cost reports, allowing cost
-              data to be filtered based on tag keys or values.
+              better organization and management. Both tag keys and values have a maximum
+              length of 255 characters. Some tags are read-only and cannot be modified by the
+              user. Tags are also integrated with cost reports, allowing cost data to be
+              filtered based on tag keys or values.
 
           type_name: Vast file share type
 
@@ -707,7 +759,6 @@ class AsyncFileSharesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
-    @typing_extensions.deprecated("deprecated")
     async def update(
         self,
         file_share_id: str,
@@ -723,12 +774,9 @@ class AsyncFileSharesResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> FileShare:
+    ) -> TaskIDList:
         """
-        Rename file share or update tags
-
-        **Deprecated**: Use PATCH
-        /v3/`file_shares`/{`project_id`}/{`region_id`}/{`file_share_id`} instead
+        Rename file share, update tags or set share specific properties
 
         Args:
           project_id: Project ID
@@ -751,15 +799,20 @@ class AsyncFileSharesResource(AsyncAPIResource):
               - **Add/update tags:**
                 `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
                 updates existing ones.
-              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
+
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+
               - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
                 tags are preserved).
+
               - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
                 specified tags.
+
               - **Mixed operations:**
-                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
                 adds/updates 'environment' and '`cost_center`' while removing
                 '`deprecated_tag`', preserving other existing tags.
+
               - **Replace all:** first delete existing tags with null values, then add new
                 ones in the same request.
 
@@ -778,7 +831,7 @@ class AsyncFileSharesResource(AsyncAPIResource):
         if not file_share_id:
             raise ValueError(f"Expected a non-empty value for `file_share_id` but received {file_share_id!r}")
         return await self._patch(
-            f"/cloud/v1/file_shares/{project_id}/{region_id}/{file_share_id}",
+            f"/cloud/v3/file_shares/{project_id}/{region_id}/{file_share_id}",
             body=await async_maybe_transform(
                 {
                     "name": name,
@@ -790,7 +843,55 @@ class AsyncFileSharesResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=FileShare,
+            cast_to=TaskIDList,
+        )
+
+    async def update_and_poll(
+        self,
+        file_share_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str | Omit = omit,
+        share_settings: file_share_update_params.ShareSettings | Omit = omit,
+        tags: Optional[TagUpdateMapParam] | Omit = omit,
+        polling_interval_seconds: int | Omit = omit,
+        polling_timeout_seconds: int | 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,
+    ) -> FileShare:
+        response = await self.update(
+            file_share_id,
+            project_id=project_id,
+            region_id=region_id,
+            name=name,
+            share_settings=share_settings,
+            tags=tags,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+            polling_timeout_seconds=polling_timeout_seconds,
+        )
+        return await self.get(
+            file_share_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
         )
 
     def list(
@@ -1006,10 +1107,11 @@ class FileSharesResourceWithRawResponse:
         self.create = to_raw_response_wrapper(
             file_shares.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            to_raw_response_wrapper(
-                file_shares.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = to_raw_response_wrapper(
+            file_shares.update,
+        )
+        self.update_and_poll = to_raw_response_wrapper(
+            file_shares.update_and_poll,
         )
         self.list = to_raw_response_wrapper(
             file_shares.list,
@@ -1036,10 +1138,11 @@ class AsyncFileSharesResourceWithRawResponse:
         self.create = async_to_raw_response_wrapper(
             file_shares.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            async_to_raw_response_wrapper(
-                file_shares.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = async_to_raw_response_wrapper(
+            file_shares.update,
+        )
+        self.update_and_poll = async_to_raw_response_wrapper(
+            file_shares.update_and_poll,
         )
         self.list = async_to_raw_response_wrapper(
             file_shares.list,
@@ -1066,10 +1169,11 @@ class FileSharesResourceWithStreamingResponse:
         self.create = to_streamed_response_wrapper(
             file_shares.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            to_streamed_response_wrapper(
-                file_shares.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = to_streamed_response_wrapper(
+            file_shares.update,
+        )
+        self.update_and_poll = to_streamed_response_wrapper(
+            file_shares.update_and_poll,
         )
         self.list = to_streamed_response_wrapper(
             file_shares.list,
@@ -1096,10 +1200,11 @@ class AsyncFileSharesResourceWithStreamingResponse:
         self.create = async_to_streamed_response_wrapper(
             file_shares.create,
         )
-        self.update = (  # pyright: ignore[reportDeprecated]
-            async_to_streamed_response_wrapper(
-                file_shares.update,  # pyright: ignore[reportDeprecated],
-            )
+        self.update = async_to_streamed_response_wrapper(
+            file_shares.update,
+        )
+        self.update_and_pol = async_to_streamed_response_wrapper(
+            file_shares.update_and_poll,
         )
         self.list = async_to_streamed_response_wrapper(
             file_shares.list,