yandexcloud 0.322.0__tar.gz → 0.324.0__tar.gz

yandexcloud-0.324.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.1
+Name: yandexcloud
+Version: 0.324.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<43,>=41.0.7
+Requires-Dist: grpcio<2,>=1.64.0
+Requires-Dist: protobuf<5,>=4.25.3
+Requires-Dist: googleapis-common-protos<2,>=1.63.0
+Requires-Dist: pyjwt<3,>=2.8.0
+Requires-Dist: requests<3,>=2.32.3
+Requires-Dist: six<2,>=1.16.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.ocr                                                    | ai-vision-ocr            |
+| 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.datasphere                                                | datasphere               |
+| 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.v1.symmetric_crypto_service                           | kms-crypto               |
+| yandex.cloud.kms                                                       | kms                      |
+| 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.websocket                           | apigateway-connections   |
+| yandex.cloud.serverless.apigateway                                     | serverless-apigateway    |
+| 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.324.0/setup.py

@@ -0,0 +1,42 @@
+from setuptools import find_packages, setup
+
+packages = find_packages(".", include=["yandexcloud*", "yandex*"])
+
+__version__ = "0.324.0"
+
+with open("README.md") as file:
+    README = file.read()
+
+setup(
+    name="yandexcloud",
+    version=__version__,
+    description="The Yandex.Cloud official SDK",
+    url="https://github.com/yandex-cloud/python-sdk",
+    author="Yandex LLC",
+    author_email="cloud@support.yandex.ru",
+    long_description=README,
+    long_description_content_type="text/markdown",
+    include_package_data=True,
+    license="MIT",
+    install_requires=[
+        "cryptography>=41.0.7,<43",
+        "grpcio>=1.64.0,<2",
+        "protobuf>=4.25.3,<5",
+        "googleapis-common-protos>=1.63.0,<2",
+        "pyjwt>=2.8.0,<3",
+        "requests>=2.32.3,<3",
+        "six>=1.16.0,<2",
+    ],
+    classifiers=[
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+    ],
+    tests_require=["pytest"],
+    packages=packages,
+    zip_safe=False,
+)

yandexcloud-0.324.0/yandex/cloud/ai/foundation_models/v1/text_common_pb2.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: yandex/cloud/ai/foundation_models/v1/text_common.proto
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
+from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n6yandex/cloud/ai/foundation_models/v1/text_common.proto\x12$yandex.cloud.ai.foundation_models.v1\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1egoogle/protobuf/wrappers.proto\"\x87\x01\n\x11\x43ompletionOptions\x12\x0e\n\x06stream\x18\x01 \x01(\x08\x12\x31\n\x0btemperature\x18\x02 \x01(\x0b\x32\x1c.google.protobuf.DoubleValue\x12/\n\nmax_tokens\x18\x03 \x01(\x0b\x32\x1b.google.protobuf.Int64Value\"\xd2\x01\n\x07Message\x12\x0c\n\x04role\x18\x01 \x01(\t\x12\x0e\n\x04text\x18\x02 \x01(\tH\x00\x12L\n\x0etool_call_list\x18\x03 \x01(\x0b\x32\x32.yandex.cloud.ai.foundation_models.v1.ToolCallListH\x00\x12P\n\x10tool_result_list\x18\x04 \x01(\x0b\x32\x34.yandex.cloud.ai.foundation_models.v1.ToolResultListH\x00\x42\t\n\x07\x43ontent\"Z\n\x0c\x43ontentUsage\x12\x19\n\x11input_text_tokens\x18\x01 \x01(\x03\x12\x19\n\x11\x63ompletion_tokens\x18\x02 \x01(\x03\x12\x14\n\x0ctotal_tokens\x18\x03 \x01(\x03\"\x8c\x03\n\x0b\x41lternative\x12>\n\x07message\x18\x01 \x01(\x0b\x32-.yandex.cloud.ai.foundation_models.v1.Message\x12S\n\x06status\x18\x02 \x01(\x0e\x32\x43.yandex.cloud.ai.foundation_models.v1.Alternative.AlternativeStatus\"\xe7\x01\n\x11\x41lternativeStatus\x12\"\n\x1e\x41LTERNATIVE_STATUS_UNSPECIFIED\x10\x00\x12\x1e\n\x1a\x41LTERNATIVE_STATUS_PARTIAL\x10\x01\x12&\n\"ALTERNATIVE_STATUS_TRUNCATED_FINAL\x10\x02\x12\x1c\n\x18\x41LTERNATIVE_STATUS_FINAL\x10\x03\x12%\n!ALTERNATIVE_STATUS_CONTENT_FILTER\x10\x04\x12!\n\x1d\x41LTERNATIVE_STATUS_TOOL_CALLS\x10\x05\"2\n\x05Token\x12\n\n\x02id\x18\x01 \x01(\x03\x12\x0c\n\x04text\x18\x02 \x01(\t\x12\x0f\n\x07special\x18\x03 \x01(\x08\"Z\n\x04Tool\x12\x46\n\x08\x66unction\x18\x01 \x01(\x0b\x32\x32.yandex.cloud.ai.foundation_models.v1.FunctionToolH\x00\x42\n\n\x08ToolType\"^\n\x0c\x46unctionTool\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12+\n\nparameters\x18\x03 \x01(\x0b\x32\x17.google.protobuf.Struct\"g\n\x08ToolCall\x12K\n\rfunction_call\x18\x01 \x01(\x0b\x32\x32.yandex.cloud.ai.foundation_models.v1.FunctionCallH\x00\x42\x0e\n\x0cToolCallType\"H\n\x0c\x46unctionCall\x12\x0c\n\x04name\x18\x01 \x01(\t\x12*\n\targuments\x18\x02 \x01(\x0b\x32\x17.google.protobuf.Struct\"R\n\x0cToolCallList\x12\x42\n\ntool_calls\x18\x01 \x03(\x0b\x32..yandex.cloud.ai.foundation_models.v1.ToolCall\"o\n\nToolResult\x12O\n\x0f\x66unction_result\x18\x01 \x01(\x0b\x32\x34.yandex.cloud.ai.foundation_models.v1.FunctionResultH\x00\x42\x10\n\x0eToolResultType\"@\n\x0e\x46unctionResult\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x11\n\x07\x63ontent\x18\x02 \x01(\tH\x00\x42\r\n\x0b\x43ontentType\"X\n\x0eToolResultList\x12\x46\n\x0ctool_results\x18\x01 \x03(\x0b\x32\x30.yandex.cloud.ai.foundation_models.v1.ToolResultB\x86\x01\n(yandex.cloud.api.ai.foundation_models.v1ZZgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/foundation_models/v1;foundation_modelsb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'yandex.cloud.ai.foundation_models.v1.text_common_pb2', _globals)
+if _descriptor._USE_C_DESCRIPTORS == False:
+  DESCRIPTOR._options = None
+  DESCRIPTOR._serialized_options = b'\n(yandex.cloud.api.ai.foundation_models.v1ZZgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/foundation_models/v1;foundation_models'
+  _globals['_COMPLETIONOPTIONS']._serialized_start=159
+  _globals['_COMPLETIONOPTIONS']._serialized_end=294
+  _globals['_MESSAGE']._serialized_start=297
+  _globals['_MESSAGE']._serialized_end=507
+  _globals['_CONTENTUSAGE']._serialized_start=509
+  _globals['_CONTENTUSAGE']._serialized_end=599
+  _globals['_ALTERNATIVE']._serialized_start=602
+  _globals['_ALTERNATIVE']._serialized_end=998
+  _globals['_ALTERNATIVE_ALTERNATIVESTATUS']._serialized_start=767
+  _globals['_ALTERNATIVE_ALTERNATIVESTATUS']._serialized_end=998
+  _globals['_TOKEN']._serialized_start=1000
+  _globals['_TOKEN']._serialized_end=1050
+  _globals['_TOOL']._serialized_start=1052
+  _globals['_TOOL']._serialized_end=1142
+  _globals['_FUNCTIONTOOL']._serialized_start=1144
+  _globals['_FUNCTIONTOOL']._serialized_end=1238
+  _globals['_TOOLCALL']._serialized_start=1240
+  _globals['_TOOLCALL']._serialized_end=1343
+  _globals['_FUNCTIONCALL']._serialized_start=1345
+  _globals['_FUNCTIONCALL']._serialized_end=1417
+  _globals['_TOOLCALLLIST']._serialized_start=1419
+  _globals['_TOOLCALLLIST']._serialized_end=1501
+  _globals['_TOOLRESULT']._serialized_start=1503
+  _globals['_TOOLRESULT']._serialized_end=1614
+  _globals['_FUNCTIONRESULT']._serialized_start=1616
+  _globals['_FUNCTIONRESULT']._serialized_end=1680
+  _globals['_TOOLRESULTLIST']._serialized_start=1682
+  _globals['_TOOLRESULTLIST']._serialized_end=1770
+# @@protoc_insertion_point(module_scope)