yandexcloud 0.285.0__py3-none-any.whl → 0.287.0__py3-none-any.whl

yandexcloud/__init__.py

@@ -1,6 +1,7 @@
 """Main package for Yandex.Cloud SDK."""
 
 # flake8: noqa
+from yandexcloud._auth_fabric import set_up_yc_api_endpoint
 from yandexcloud._backoff import (
     backoff_exponential_with_jitter,
     backoff_linear_with_jitter,

yandexcloud/_auth_fabric.py

@@ -19,6 +19,13 @@ _MDS_TIMEOUT = (1.0, 1.0)  # 1sec connect, 1sec read
 YC_API_ENDPOINT = "api.cloud.yandex.net"
 
 
+def set_up_yc_api_endpoint(endpoint: str) -> str:
+    # pylint: disable-next=global-statement
+    global YC_API_ENDPOINT
+    YC_API_ENDPOINT = endpoint
+    return YC_API_ENDPOINT
+
+
 def __validate_service_account_key(sa_key):
     if not isinstance(sa_key, dict):
         raise RuntimeError("Invalid Service Account Key: expecting dictionary, actually got {}".format(type(sa_key)))
@@ -46,9 +53,9 @@ def __validate_service_account_key(sa_key):
         raise RuntimeError(error_message)
 
 
-def get_auth_token_requester(
-    token=None, service_account_key=None, iam_token=None, metadata_addr=None, endpoint=YC_API_ENDPOINT
-):
+def get_auth_token_requester(token=None, service_account_key=None, iam_token=None, metadata_addr=None, endpoint=None):
+    if endpoint is None:
+        endpoint = YC_API_ENDPOINT
     auth_methods = [("token", token), ("service_account_key", service_account_key), ("iam_token", iam_token)]
     auth_methods = [(auth_type, value) for auth_type, value in auth_methods if value is not None]
 
@@ -97,9 +104,9 @@ class TokenAuth:
 class ServiceAccountAuth:
     __SECONDS_IN_HOUR = 60.0 * 60.0
 
-    def __init__(self, sa_key, endpoint=YC_API_ENDPOINT):
+    def __init__(self, sa_key, endpoint=None):
         self.__sa_key = sa_key
-        self._endpoint = endpoint
+        self._endpoint = endpoint if endpoint is not None else YC_API_ENDPOINT
 
     def get_token_request(self):
         return CreateIamTokenRequest(jwt=self.__prepare_request(self._endpoint))

yandexcloud/_channels.py

@@ -1,4 +1,6 @@
+import logging
 from importlib.metadata import PackageNotFoundError, version
+from typing import Dict, Optional
 
 import grpc
 
@@ -13,10 +15,11 @@ except PackageNotFoundError:
     VERSION = "0.0.0"
 
 SDK_USER_AGENT = "yandex-cloud-python-sdk/{version}".format(version=VERSION)
+logger = logging.getLogger(__name__)
 
 
-class Channels(object):
-    def __init__(self, client_user_agent=None, **kwargs):
+class Channels:
+    def __init__(self, client_user_agent=None, endpoints: Optional[Dict[str, str]] = None, **kwargs):
         self._channel_creds = grpc.ssl_channel_credentials(
             root_certificates=kwargs.get("root_certificates"),
             private_key=kwargs.get("private_key"),
@@ -30,35 +33,68 @@ class Channels(object):
             endpoint=self._endpoint,
         )
 
-        self._unauthenticated_channel = None
-        self._channels = None
         self._client_user_agent = client_user_agent
-
-    def channel_options(self):
-        return tuple(
+        self._config_endpoints = endpoints if endpoints is not None else {}
+        self._endpoints = None
+        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
         )
 
-    def channel(self, endpoint):
-        if not self._channels:
-            self._unauthenticated_channel = grpc.secure_channel(
-                self._endpoint, self._channel_creds, options=self.channel_options()
+    def channel(self, service: str, endpoint: Optional[str] = None, insecure: bool = False) -> grpc.Channel:
+        if endpoint:
+            logger.info("Using provided service %s endpoint %s", service, endpoint)
+            if insecure:
+                logger.info("Insecure option is ON, no IAM endpoint used for verification")
+                return grpc.insecure_channel(endpoint, options=self.channel_options)
+            logger.info("Insecure option is OFF,IAM endpoint %s used for verification")
+            creds = self._get_creds(self.endpoints["iam"])
+            return grpc.secure_channel(endpoint, creds, options=self.channel_options)
+        if service not in self._config_endpoints and insecure:
+            logger.warning(
+                "Unable to use insecure option for default {%s} service endpoint.\n"
+                "Option is ignored. To enable it override endpoint.",
+                service,
             )
-            endpoint_service = ApiEndpointServiceStub(self._unauthenticated_channel)
-            resp = endpoint_service.List(ListApiEndpointsRequest())
-            endpoints = resp.endpoints
+        elif insecure:
+            logger.info("Insecure option is ON, no IAM endpoint used for verification")
+            return grpc.insecure_channel(self.endpoints[service], options=self.channel_options)
+
+        logger.info(
+            "Using endpoints from configuration, IAM %s, %s %s",
+            self.endpoints["iam"],
+            service,
+            self.endpoints[service],
+        )
 
-            plugin = _auth_plugin.Credentials(self._token_requester, lambda: self._channels["iam"])
-            call_creds = grpc.metadata_call_credentials(plugin)
-            creds = grpc.composite_channel_credentials(self._channel_creds, call_creds)
+        creds = self._get_creds(self.endpoints["iam"])
+        if service not in self.endpoints:
+            raise RuntimeError(f"Unknown service: {service}")
+        return grpc.secure_channel(self.endpoints[service], creds, options=self.channel_options)
 
-            self._channels = {
-                ep.id: grpc.secure_channel(ep.address, creds, options=self.channel_options()) for ep in endpoints
-            }
+    @property
+    def endpoints(self) -> Optional[dict]:
+        if self._endpoints is None:
+            self._endpoints = self._get_endpoints()
+            for id_, address in self._config_endpoints.items():
+                logger.debug("Override service %s, endpoint %s", id_, address)
+                if id_ == "iam":
+                    logger.warning(
+                        "Be aware `iam` service endpoint is overridden. "
+                        "That can produce unexpected results in SDK calls."
+                    )
+                self._endpoints[id_] = address
+        return self._endpoints
 
-        if endpoint not in self._channels:
-            raise RuntimeError("Unknown endpoint: {}".format(endpoint))
+    def _get_endpoints(self) -> Dict[str, str]:
+        unauthenticated_channel = grpc.secure_channel(self._endpoint, self._channel_creds, options=self.channel_options)
+        endpoint_service = ApiEndpointServiceStub(unauthenticated_channel)
+        resp = endpoint_service.List(ListApiEndpointsRequest())
+        return {endpoint.id: endpoint.address for endpoint in resp.endpoints}
 
-        return self._channels[endpoint]
+    def _get_creds(self, iam_endpoint: str) -> grpc.ChannelCredentials:
+        plugin = _auth_plugin.Credentials(self._token_requester, lambda: iam_endpoint)
+        call_creds = grpc.metadata_call_credentials(plugin)
+        creds = grpc.composite_channel_credentials(self._channel_creds, call_creds)
+        return creds

yandexcloud/_sdk.py

@@ -1,4 +1,5 @@
 import inspect
+from typing import Dict, Optional
 
 import grpc
 
@@ -8,8 +9,8 @@ from yandexcloud._retry_interceptor import RetryInterceptor
 from yandexcloud._wrappers import Wrappers
 
 
-class SDK(object):
-    def __init__(self, interceptor=None, user_agent=None, **kwargs):
+class SDK:
+    def __init__(self, interceptor=None, user_agent=None, endpoints: Optional[Dict[str, str]] = None, **kwargs):
         """
         API entry-point object.
 
@@ -22,8 +23,10 @@ class SDK(object):
         ]
         :param user_agent: String to prepend User-Agent metadata header for all GRPC requests made via SDK object
         :type user_agent: Optional[str]
+        :param endpoints: Dict with services endpoints overrides. Example: {'vpc': 'new.vpc.endpoint:443'}
+
         """
-        self._channels = _channels.Channels(client_user_agent=user_agent, **kwargs)
+        self._channels = _channels.Channels(client_user_agent=user_agent, endpoints=endpoints, **kwargs)
         if interceptor is None:
             interceptor = RetryInterceptor(
                 max_retry_count=5,
@@ -37,9 +40,9 @@ class SDK(object):
     def set_interceptor(self, interceptor):
         self._default_interceptor = interceptor
 
-    def client(self, stub_ctor, interceptor=None):
+    def client(self, stub_ctor, interceptor=None, endpoint: Optional[str] = None, insecure: bool = False):
         service = _service_for_ctor(stub_ctor)
-        channel = self._channels.channel(service)
+        channel = self._channels.channel(service, endpoint, insecure)
         if interceptor is not None:
             channel = grpc.intercept_channel(channel, interceptor)
         elif self._default_interceptor is not None:

yandexcloud/auth.py

@@ -8,7 +8,9 @@ from yandexcloud._auth_fabric import (
 )
 
 
-def get_auth_token(token=None, service_account_key=None, iam_token=None, metadata_addr=None, endpoint=YC_API_ENDPOINT):
+def get_auth_token(token=None, service_account_key=None, iam_token=None, metadata_addr=None, endpoint=None):
+    if endpoint is None:
+        endpoint = YC_API_ENDPOINT
     requester = get_auth_token_requester(
         token=token,
         service_account_key=service_account_key,

yandexcloud-0.287.0.dist-info/METADATA

@@ -0,0 +1,203 @@
+Metadata-Version: 2.1
+Name: yandexcloud
+Version: 0.287.0
+Summary: The Yandex.Cloud official SDK
+Home-page: https://github.com/yandex-cloud/python-sdk
+Author: Yandex LLC
+Author-email: cloud@support.yandex.ru
+License: MIT
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: cryptography >=2.8
+Requires-Dist: grpcio >=1.59.3
+Requires-Dist: protobuf >=4.23.4
+Requires-Dist: googleapis-common-protos >=1.59.1
+Requires-Dist: pyjwt >=1.7.1
+Requires-Dist: requests >=2.22.0
+Requires-Dist: six >=1.14.0
+
+[![PyPI Version][pypi-image]][pypi-url]
+[![Build Status][build-image]][build-url]
+[![License][license-image]][license-url]
+
+<!-- Badges -->
+
+[pypi-image]: https://img.shields.io/pypi/v/yandexcloud
+[pypi-url]: https://pypi.org/project/yandexcloud/
+[build-image]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml/badge.svg
+[build-url]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml
+[license-image]: https://img.shields.io/github/license/yandex-cloud/python-sdk.svg
+[license-url]: https://github.com/yandex-cloud/python-sdk/blob/master/LICENSE
+
+# Yandex.Cloud SDK (Python) 
+
+Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.
+
+Installation:
+
+    pip install yandexcloud
+
+## Getting started
+
+There are several options for authorization your requests - OAuth Token,
+Metadata Service (if you're executing your code inside VMs or Cloud Functions
+running in Yandex.Cloud), Service Account Keys, and externally created IAM tokens.
+
+### OAuth Token
+
+```python
+sdk = yandexcloud.SDK(token='AQAD-.....')
+```
+
+### Metadata Service
+
+Don't forget to assign Service Account for your Instance or Function and grant required roles.
+
+```python
+sdk = yandexcloud.SDK()
+```
+
+### Service Account Keys
+
+```python
+# you can store and read it from JSON file 
+sa_key = {
+    "id": "...",
+    "service_account_id": "...",
+    "private_key": "..."
+}
+
+sdk = yandexcloud.SDK(service_account_key=sa_key)
+```
+
+### IAM tokens
+
+```python
+sdk = yandexcloud.SDK(iam_token="t1.9eu...")
+```
+
+Check `examples` directory for more examples.
+
+### Override service endpoint
+
+#### Supported services
+
+| Service Name                                                           | Alias                    |
+|------------------------------------------------------------------------|--------------------------|
+| yandex.cloud.ai.foundation_models                                      | ai-foundation-models     |
+| yandex.cloud.ai.llm                                                    | ai-llm                   |
+| yandex.cloud.ai.stt                                                    | ai-stt                   |
+| yandex.cloud.ai.translate                                              | ai-translate             |
+| yandex.cloud.ai.tts                                                    | ai-speechkit             |
+| yandex.cloud.ai.vision                                                 | ai-vision                |
+| yandex.cloud.apploadbalancer                                           | alb                      |
+| yandex.cloud.billing                                                   | billing                  |
+| yandex.cloud.cdn                                                       | cdn                      |
+| yandex.cloud.certificatemanager.v1.certificate_content_service         | certificate-manager-data |
+| yandex.cloud.certificatemanager                                        | certificate-manager      |
+| yandex.cloud.compute                                                   | compute                  |
+| yandex.cloud.containerregistry                                         | container-registry       |
+| yandex.cloud.dataproc.manager                                          | dataproc-manager         |
+| yandex.cloud.dataproc                                                  | dataproc                 |
+| yandex.cloud.datatransfer                                              | datatransfer             |
+| yandex.cloud.dns                                                       | dns                      |
+| yandex.cloud.endpoint                                                  | endpoint                 |
+| yandex.cloud.iam                                                       | iam                      |
+| yandex.cloud.iot.devices                                               | iot-devices              |
+| yandex.cloud.k8s                                                       | managed-kubernetes       |
+| yandex.cloud.kms                                                       | kms                      |
+| yandex.cloud.kms.v1.symmetric_crypto_service                           | kms-crypto               |
+| yandex.cloud.loadbalancer                                              | load-balancer            |
+| yandex.cloud.loadtesting                                               | loadtesting              |
+| yandex.cloud.lockbox.v1.payload_service                                | lockbox-payload          |
+| yandex.cloud.lockbox                                                   | lockbox                  |
+| yandex.cloud.logging.v1.log_ingestion_service                          | log-ingestion            |
+| yandex.cloud.logging.v1.log_reading_service                            | log-reading              |
+| yandex.cloud.logging                                                   | logging                  |
+| yandex.cloud.marketplace                                               | marketplace              |
+| yandex.cloud.mdb.clickhouse                                            | managed-clickhouse       |
+| yandex.cloud.mdb.elasticsearch                                         | managed-elasticsearch    |
+| yandex.cloud.mdb.greenplum                                             | managed-greenplum        |
+| yandex.cloud.mdb.kafka                                                 | managed-kafka            |
+| yandex.cloud.mdb.mongodb                                               | managed-mongodb          |
+| yandex.cloud.mdb.mysql                                                 | managed-mysql            |
+| yandex.cloud.mdb.opensearch                                            | managed-opensearch       |
+| yandex.cloud.mdb.postgresql                                            | managed-postgresql       |
+| yandex.cloud.mdb.redis                                                 | managed-redis            |
+| yandex.cloud.mdb.sqlserver                                             | managed-sqlserver        |
+| yandex.cloud.operation                                                 | operation                |
+| yandex.cloud.organizationmanager                                       | organization-manager     |
+| yandex.cloud.resourcemanager                                           | resource-manager         |
+| yandex.cloud.serverless.apigateway                                     | serverless-apigateway    |
+| yandex.cloud.serverless.apigateway.websocket                           | apigateway-connections   |
+| yandex.cloud.serverless.containers                                     | serverless-containers    |
+| yandex.cloud.serverless.functions                                      | serverless-functions     |
+| yandex.cloud.serverless.triggers                                       | serverless-triggers      |
+| yandex.cloud.storage                                                   | storage-api              |
+| yandex.cloud.vpc                                                       | vpc                      |
+| yandex.cloud.ydb                                                       | ydb                      |
+
+
+#### Override in client
+```python
+from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
+from yandexcloud import SDK
+
+sdk = SDK(iam_token="t1.9eu...")
+new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
+insecure = False # by default is False, but if server does not support verification can be set to True
+network_client = sdk.client(NetworkServiceStub, endpoint=new_network_client_endpoint, insecure=False)
+```
+
+#### Override in sdk config
+To override endpoints provide dict in format {alias : new-endpoint}
+```python
+from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
+from yandexcloud import SDK
+new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
+sdk = SDK(iam_token="t1.9eu...", endpoints={"vpc": new_network_client_endpoint})
+insecure = False # by default is False, but if server does not support verification can be set to True
+network_client = sdk.client(NetworkServiceStub, insecure=False)
+```
+
+Notice: if both overrides are used for same endpoint, override by client has priority
+
+#### Switch SDK region
+```python
+from yandexcloud import SDK, set_up_yc_api_endpoint
+kz_region_endpoint = "api.yandexcloud.kz"
+# this will make SDK list endpoints from KZ yc installation 
+sdk = SDK(iam_token="t1.9eu...", endpoint="api.yandexcloud.kz")
+# or you can use global function
+set_up_yc_api_endpoint(kz_region_endpoint)
+```
+
+## Contributing
+### Dependencies
+Use `make deps` command to install library, its production and development dependencies.
+
+### Formatting
+Use `make format` to autoformat code with black tool. 
+
+### Tests
+- `make test` to run tests for current python version
+- `make lint` to run only linters for current python version
+- `make tox-current` to run all checks (tests + code style checks + linters + format check) for current python version
+- `make tox` to run all checks for all supported (installed in your system) python versions
+- `make test-all-versions` to run all checks for all supported python versions in docker container
+
+
+### Maintaining
+If pull request consists of several meaningful commits, that should be preserved, 
+then use "Rebase and merge" option. Otherwise use "Squash and merge". 
+
+New release (changelog, tag and pypi upload) will be automatically created 
+on each push to master via Github Actions workflow.

{yandexcloud-0.285.0.dist-info → yandexcloud-0.287.0.dist-info}/RECORD

@@ -1235,22 +1235,22 @@ yandex/cloud/ydb/v1/storage_type_pb2.py,sha256=Y7KzpsgrWOmo2TlW2aluwRg0Xw2i3Jy-s
 yandex/cloud/ydb/v1/storage_type_pb2_grpc.py,sha256=1oboBPFxaTEXt9Aw7EAj8gXHDCNMhZD2VXqocC9l_gk,159
 yandex/cloud/ydb/v1/storage_type_service_pb2.py,sha256=cTajsoT_mKDO5p_4HQOgvjTdz7XqRdjtWi3xK9eY6tI,3723
 yandex/cloud/ydb/v1/storage_type_service_pb2_grpc.py,sha256=3156bynSw7aG4iU-Wbjuwt8ivF41QoiLNyOslnX_TKo,4791
-yandexcloud/__init__.py,sha256=kejXeZTGc_7z9mQGPFJj9NVy3g1j6_RcNuRbojG3TPA,300
-yandexcloud/_auth_fabric.py,sha256=HoDbZ02ezQGYWV9HSklEsa3_cOgb3uEzvqHqtwzMGW4,4459
+yandexcloud/__init__.py,sha256=NQG4NAbBlUJGEt15OlUA3RZbW2wD9vjkwhp1Hu-DRUU,360
+yandexcloud/_auth_fabric.py,sha256=o5Rrk0O7cNaLZRHk0Xc2aMj4DcUdUwmCReRWKpR3ZaU,4717
 yandexcloud/_auth_plugin.py,sha256=DHYliuD3PYPfONOcmTpJoDNFKfgwsQbe0z3N7d44A6A,2709
 yandexcloud/_backoff.py,sha256=ptd32-4wNNlZBexi34GIbI2DKxQILHWq_mVSgTdO_3I,956
-yandexcloud/_channels.py,sha256=tUFBlrlK_lVtCicsqsv3zTjBov-Iz8XV-8qvQRxGzSU,2531
+yandexcloud/_channels.py,sha256=nf6Y64RhW0gb_7fg_HLzIafbRnkpQrQF3Lp2egA5BIA,4588
 yandexcloud/_helpers.py,sha256=wtkkvklZYnFSTl9ge16ryR-e9kyeWOlSFCBpoL-f3-g,3388
 yandexcloud/_operation_waiter.py,sha256=Fg2BRdOpVZwD5QQDUTlWTseclsjkwcEn3fyAH7bezDo,4160
 yandexcloud/_retry_interceptor.py,sha256=W7JVatSB8bGwinUH4Bq2URbticG2atVuYhceivuUJwc,6518
-yandexcloud/_sdk.py,sha256=lPI6MwfXDFhhhmaQgM_4YQ1gPoInI9rBwAWDBgXM1sQ,5843
-yandexcloud/auth.py,sha256=5TAWX4UtVMfQ-WX_GomFJ4podNflvmAWRImdHhKwNvo,793
+yandexcloud/_sdk.py,sha256=vlYJFETnma6dTImt72GNuzADMPLhE495WjnB5ck9bNo,6118
+yandexcloud/auth.py,sha256=klB0yFOImdZKcHpAwIxNJib7CsSpTN0eC2r9kLkf7C0,842
 yandexcloud/operations.py,sha256=ajTQtALe76_77uYVCUPQ2KAkRRhdmjqbt-jFIVKNULg,448
 yandexcloud/_wrappers/__init__.py,sha256=_GdM0-eMpcQCmyNHlnqTHpLzN0riBLaq-ACVavLNSrM,251
 yandexcloud/_wrappers/dataproc/__init__.py,sha256=3YXJfktefML0KRNMtTFXncbswIdd9yBlqQkhDqclang,33215
-yandexcloud-0.285.0.dist-info/AUTHORS,sha256=BYzvivX5Y67xcqFAJhmqcKy5UwHCngxlnDt4i_PhNO4,264
-yandexcloud-0.285.0.dist-info/LICENSE,sha256=AFcOYhNOyuBQP89lObqyipdScN2KUUS-OuWoUlVo6yE,1077
-yandexcloud-0.285.0.dist-info/METADATA,sha256=X24Oqw1opu3IeXO_4Jb7YvL1IuhXcLuGTmeYiGj9MiE,3424
-yandexcloud-0.285.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-yandexcloud-0.285.0.dist-info/top_level.txt,sha256=p6aBMPGD526A1jM2WVnAneI2qO4kGDWeJi6uwYApDqg,19
-yandexcloud-0.285.0.dist-info/RECORD,,
+yandexcloud-0.287.0.dist-info/AUTHORS,sha256=BYzvivX5Y67xcqFAJhmqcKy5UwHCngxlnDt4i_PhNO4,264
+yandexcloud-0.287.0.dist-info/LICENSE,sha256=AFcOYhNOyuBQP89lObqyipdScN2KUUS-OuWoUlVo6yE,1077
+yandexcloud-0.287.0.dist-info/METADATA,sha256=m9uoa1Rh6JeQdV1UooG_jNbfcqKBDr0QDEHkSDbgza8,10394
+yandexcloud-0.287.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+yandexcloud-0.287.0.dist-info/top_level.txt,sha256=p6aBMPGD526A1jM2WVnAneI2qO4kGDWeJi6uwYApDqg,19
+yandexcloud-0.287.0.dist-info/RECORD,,

yandexcloud-0.285.0.dist-info/METADATA

@@ -1,110 +0,0 @@
-Metadata-Version: 2.1
-Name: yandexcloud
-Version: 0.285.0
-Summary: The Yandex.Cloud official SDK
-Home-page: https://github.com/yandex-cloud/python-sdk
-Author: Yandex LLC
-Author-email: cloud@support.yandex.ru
-License: MIT
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: AUTHORS
-Requires-Dist: cryptography >=2.8
-Requires-Dist: grpcio >=1.59.3
-Requires-Dist: protobuf >=4.23.4
-Requires-Dist: googleapis-common-protos >=1.59.1
-Requires-Dist: pyjwt >=1.7.1
-Requires-Dist: requests >=2.22.0
-Requires-Dist: six >=1.14.0
-
-[![PyPI Version][pypi-image]][pypi-url]
-[![Build Status][build-image]][build-url]
-[![License][license-image]][license-url]
-
-<!-- Badges -->
-
-[pypi-image]: https://img.shields.io/pypi/v/yandexcloud
-[pypi-url]: https://pypi.org/project/yandexcloud/
-[build-image]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml/badge.svg
-[build-url]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml
-[license-image]: https://img.shields.io/github/license/yandex-cloud/python-sdk.svg
-[license-url]: https://github.com/yandex-cloud/python-sdk/blob/master/LICENSE
-
-# Yandex.Cloud SDK (Python) 
-
-Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.
-
-Installation:
-
-    pip install yandexcloud
-
-## Getting started
-
-There are several options for authorization your requests - OAuth Token,
-Metadata Service (if you're executing your code inside VMs or Cloud Functions
-running in Yandex.Cloud), Service Account Keys, and externally created IAM tokens.
-
-### OAuth Token
-
-```python
-sdk = yandexcloud.SDK(token='AQAD-.....')
-```
-
-### Metadata Service
-
-Don't forget to assign Service Account for your Instance or Function and grant required roles.
-
-```python
-sdk = yandexcloud.SDK()
-```
-
-### Service Account Keys
-
-```python
-# you can store and read it from JSON file 
-sa_key = {
-    "id": "...",
-    "service_account_id": "...",
-    "private_key": "..."
-}
-
-sdk = yandexcloud.SDK(service_account_key=sa_key)
-```
-
-### IAM tokens
-
-```python
-sdk = yandexcloud.SDK(iam_token="t1.9eu...")
-```
-
-Check `examples` directory for more examples.
-
-
-## Contributing
-### Dependencies
-Use `make deps` command to install library, its production and development dependencies.
-
-### Formatting
-Use `make format` to autoformat code with black tool. 
-
-### Tests
-- `make test` to run tests for current python version
-- `make lint` to run only linters for current python version
-- `make tox-current` to run all checks (tests + code style checks + linters + format check) for current python version
-- `make tox` to run all checks for all supported (installed in your system) python versions
-- `make test-all-versions` to run all checks for all supported python versions in docker container
-
-
-### Maintaining
-If pull request consists of several meaningful commits, that should be preserved, 
-then use "Rebase and merge" option. Otherwise use "Squash and merge". 
-
-New release (changelog, tag and pypi upload) will be automatically created 
-on each push to master via Github Actions workflow.