yandexcloud 0.333.0__py3-none-any.whl → 0.335.0__py3-none-any.whl

yandex/cloud/vpc/v1/subnet_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/vpc/v1/subnet.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/vpc/v1/subnet.proto'
 )

yandex/cloud/vpc/v1/subnet_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/vpc/v1/subnet_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/vpc/v1/subnet_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/vpc/v1/subnet_service.proto'
 )

yandex/cloud/vpc/v1/subnet_service_pb2_grpc.py

@@ -7,7 +7,7 @@ from yandex.cloud.operation import operation_pb2 as yandex_dot_cloud_dot_operati
 from yandex.cloud.vpc.v1 import subnet_pb2 as yandex_dot_cloud_dot_vpc_dot_v1_dot_subnet__pb2
 from yandex.cloud.vpc.v1 import subnet_service_pb2 as yandex_dot_cloud_dot_vpc_dot_v1_dot_subnet__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/backup_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/backup.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/backup.proto'
 )

yandex/cloud/ydb/v1/backup_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/backup_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/backup_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/backup_service.proto'
 )

yandex/cloud/ydb/v1/backup_service_pb2_grpc.py

@@ -8,7 +8,7 @@ from yandex.cloud.operation import operation_pb2 as yandex_dot_cloud_dot_operati
 from yandex.cloud.ydb.v1 import backup_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_backup__pb2
 from yandex.cloud.ydb.v1 import backup_service_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_backup__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/database_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/database.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/database.proto'
 )

yandex/cloud/ydb/v1/database_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/database_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/database_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/database_service.proto'
 )

yandex/cloud/ydb/v1/database_service_pb2_grpc.py

@@ -8,7 +8,7 @@ from yandex.cloud.operation import operation_pb2 as yandex_dot_cloud_dot_operati
 from yandex.cloud.ydb.v1 import database_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_database__pb2
 from yandex.cloud.ydb.v1 import database_service_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_database__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/location_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/location.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/location.proto'
 )

yandex/cloud/ydb/v1/location_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/location_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/location_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/location_service.proto'
 )

yandex/cloud/ydb/v1/location_service_pb2_grpc.py

@@ -6,7 +6,7 @@ import warnings
 from yandex.cloud.ydb.v1 import location_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_location__pb2
 from yandex.cloud.ydb.v1 import location_service_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_location__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/resource_preset_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/resource_preset.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/resource_preset.proto'
 )

yandex/cloud/ydb/v1/resource_preset_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/resource_preset_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/resource_preset_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/resource_preset_service.proto'
 )

yandex/cloud/ydb/v1/resource_preset_service_pb2_grpc.py

@@ -6,7 +6,7 @@ import warnings
 from yandex.cloud.ydb.v1 import resource_preset_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_resource__preset__pb2
 from yandex.cloud.ydb.v1 import resource_preset_service_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_resource__preset__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/storage_type_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/storage_type.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/storage_type.proto'
 )

yandex/cloud/ydb/v1/storage_type_pb2_grpc.py

@@ -4,7 +4,7 @@ import grpc
 import warnings
 
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandex/cloud/ydb/v1/storage_type_service_pb2.py

@@ -2,7 +2,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # NO CHECKED-IN PROTOBUF GENCODE
 # source: yandex/cloud/ydb/v1/storage_type_service.proto
-# Protobuf Python Version: 5.28.1
+# Protobuf Python Version: 5.29.0
 """Generated protocol buffer code."""
 from google.protobuf import descriptor as _descriptor
 from google.protobuf import descriptor_pool as _descriptor_pool
@@ -12,8 +12,8 @@ from google.protobuf.internal import builder as _builder
 _runtime_version.ValidateProtobufRuntimeVersion(
     _runtime_version.Domain.PUBLIC,
     5,
-    28,
-    1,
+    29,
+    0,
     '',
     'yandex/cloud/ydb/v1/storage_type_service.proto'
 )

yandex/cloud/ydb/v1/storage_type_service_pb2_grpc.py

@@ -6,7 +6,7 @@ import warnings
 from yandex.cloud.ydb.v1 import storage_type_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_storage__type__pb2
 from yandex.cloud.ydb.v1 import storage_type_service_pb2 as yandex_dot_cloud_dot_ydb_dot_v1_dot_storage__type__service__pb2
 
-GRPC_GENERATED_VERSION = '1.68.1'
+GRPC_GENERATED_VERSION = '1.70.0'
 GRPC_VERSION = grpc.__version__
 _version_not_supported = False
 

yandexcloud/__init__.py

@@ -8,6 +8,7 @@ from yandexcloud._backoff import (
     default_backoff,
 )
 from yandexcloud._retry_interceptor import RetryInterceptor
+from yandexcloud._retry_policy import RetryPolicy
 from yandexcloud._sdk import SDK
 
-__version__ = "0.333.0"
+__version__ = "0.335.0"

yandexcloud/_channels.py

@@ -30,6 +30,7 @@ class Channels:
         root_certificates: Optional[bytes] = None,
         private_key: Optional[bytes] = None,
         certificate_chain: Optional[bytes] = None,
+        service_config: Optional[str] = None,
         **_: str,
     ) -> None:
         self._channel_creds = grpc.ssl_channel_credentials(
@@ -48,10 +49,14 @@ class Channels:
         self._client_user_agent = client_user_agent
         self._config_endpoints = endpoints if endpoints is not None else {}
         self._endpoints: Optional[Dict[str, str]] = None
+        # flake8: noqa
         self.channel_options = tuple(
-            ("grpc.primary_user_agent", user_agent)
-            for user_agent in [self._client_user_agent, SDK_USER_AGENT]
-            if user_agent is not None
+            [
+                ("grpc.primary_user_agent", user_agent)
+                for user_agent in [self._client_user_agent, SDK_USER_AGENT]
+                if user_agent is not None
+            ]
+            + ([("grpc.service_config", service_config)] if service_config is not None else [])
         )
 
     def channel(self, service: str, endpoint: Optional[str] = None, insecure: bool = False) -> grpc.Channel:

yandexcloud/_retry_interceptor.py

@@ -4,6 +4,7 @@ import uuid
 from typing import Callable, Iterable, Optional
 
 import grpc
+from deprecated import deprecated
 
 
 class _ClientCallDetails(
@@ -19,6 +20,7 @@ class _RetryCall(Exception):
     pass
 
 
+@deprecated(version="0.335.0", reason="Instead of this class use retry_policy field when building the SDK")
 class RetryInterceptor(grpc.UnaryUnaryClientInterceptor):
     """RetryInterceptor implements grpc retries.
     It supports retries quantity, list of retriable codes, backoff function,

yandexcloud/_retry_policy.py

@@ -0,0 +1,31 @@
+import json
+from typing import Tuple
+
+import grpc
+
+
+class RetryPolicy:
+    def __init__(
+        self,
+        max_attempts: int = 4,
+        status_codes: Tuple["grpc.StatusCode"] = (grpc.StatusCode.UNAVAILABLE,),
+    ):
+        self.__policy = {
+            "methodConfig": [
+                {
+                    "name": [{}],
+                    "retryPolicy": {
+                        "maxAttempts": max_attempts,
+                        "initialBackoff": "0.1s",
+                        "maxBackoff": "20s",
+                        "backoffMultiplier": 2,
+                        "retryableStatusCodes": [status.name for status in status_codes],
+                    },
+                }
+            ],
+            "retryThrottling": {"maxTokens": 100, "tokenRatio": 0.1},
+            "waitForReady": True,
+        }
+
+    def to_json(self) -> str:
+        return json.dumps(self.__policy)

yandexcloud/_sdk.py

@@ -3,9 +3,7 @@ from typing import TYPE_CHECKING, Any, Dict, Optional, Type, Union
 
 import grpc
 
-from yandexcloud import _channels, _helpers, _operation_waiter
-from yandexcloud._backoff import backoff_exponential_with_jitter
-from yandexcloud._retry_interceptor import RetryInterceptor
+from yandexcloud import _channels, _helpers, _operation_waiter, _retry_policy
 from yandexcloud._wrappers import Wrappers
 
 if TYPE_CHECKING:
@@ -41,14 +39,16 @@ class SDK:
         root_certificates: Optional[bytes] = None,
         private_key: Optional[bytes] = None,
         certificate_chain: Optional[bytes] = None,
+        retry_policy: Optional[_retry_policy.RetryPolicy] = None,
         **kwargs: str,
     ):
         """
         API entry-point object.
 
-        :param interceptor: GRPC interceptor to be used instead of default RetryInterceptor
+        :param interceptor: GRPC interceptor to be used
         :param user_agent: String to prepend User-Agent metadata header for all GRPC requests made via SDK object
         :param endpoints: Dict with services endpoints overrides. Example: {'vpc': 'new.vpc.endpoint:443'}
+        :param retry_policy: Retry policy configuration object to retry all failed GRPC requests
 
         """
         self._channels = _channels.Channels(
@@ -61,14 +61,9 @@ class SDK:
             root_certificates,
             private_key,
             certificate_chain,
+            retry_policy.to_json() if retry_policy is not None else None,
             **kwargs,
         )
-        if interceptor is None:
-            interceptor = RetryInterceptor(
-                max_retry_count=5,
-                per_call_timeout=30,
-                back_off_func=backoff_exponential_with_jitter(1, 30),
-            )
         self._default_interceptor = interceptor
         self.helpers = _helpers.Helpers(self)
         self.wrappers = Wrappers(self)

{yandexcloud-0.333.0.dist-info → yandexcloud-0.335.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: yandexcloud
-Version: 0.333.0
+Version: 0.335.0
 Summary: The Yandex Cloud official SDK
 Author-email: Yandex LLC <cloud@support.yandex.ru>
 License: MIT
@@ -16,14 +16,15 @@ Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: AUTHORS
-Requires-Dist: cryptography>=43.0.1
-Requires-Dist: grpcio<2,>=1.64.0
-Requires-Dist: protobuf<6,>=5.0.0
-Requires-Dist: googleapis-common-protos<2,>=1.63.0
-Requires-Dist: pyjwt<3,>=2.8.0
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: grpcio<2,>=1.68.1
+Requires-Dist: protobuf<6,>=5.29.1
+Requires-Dist: googleapis-common-protos<2,>=1.66.0
+Requires-Dist: pyjwt<3,>=2.10.1
 Requires-Dist: requests<3,>=2.32.3
-Requires-Dist: six<2,>=1.16.0
-Requires-Dist: grpcio-tools>=1.59.3
+Requires-Dist: six<2,>=1.17.0
+Requires-Dist: grpcio-tools>=1.68.1
+Requires-Dist: deprecated>=1.2.18
 
 [![PyPI Version][pypi-image]][pypi-url]
 [![Build Status][build-image]][build-url]
@@ -183,6 +184,24 @@ sdk = SDK(iam_token="t1.9eu...", endpoint="api.yandexcloud.kz")
 set_up_yc_api_endpoint(kz_region_endpoint)
 ```
 
+### Retries
+If you want to retry SDK requests, build SDK with `retry_policy` field using `RetryPolicy` class:
+
+```python
+import grpc
+from yandexcloud import SDK, RetryPolicy
+
+sdk = SDK(retry_policy=RetryPolicy(max_attempts=2, status_codes=(grpc.StatusCode.UNAVAILABLE,)))
+```
+
+It's **strongly recommended** to use default settings of RetryPolicy to avoid retry amplification:
+```python
+import grpc
+from yandexcloud import SDK, RetryPolicy
+
+sdk = SDK(retry_policy=RetryPolicy())
+```
+
 ## Contributing
 ### Dependencies
 We use [uv](https://docs.astral.sh/uv) to manage dependencies and run commands in Makefile.