feat: add pyi files for working with type hinting 🦆

buf.gen.yaml

@@ -2,5 +2,7 @@ version: v1
 plugins:
   - plugin: buf.build/protocolbuffers/python
     out: ../.
-  - plugin:  buf.build/grpc/python
+  - plugin: buf.build/grpc/python
+    out: ../.
+  - plugin: buf.build/protocolbuffers/pyi
     out: ../.

doublecloud/clickhouse/v1/backup_pb2.pyi

@@ -0,0 +1,35 @@
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Backup(_message.Message):
+    __slots__ = ["id", "project_id", "name", "create_time", "start_time", "source_cluster_id", "size", "type"]
+    class Type(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+        __slots__ = []
+        TYPE_INVALID: _ClassVar[Backup.Type]
+        TYPE_AUTOMATED: _ClassVar[Backup.Type]
+        TYPE_MANUAL: _ClassVar[Backup.Type]
+    TYPE_INVALID: Backup.Type
+    TYPE_AUTOMATED: Backup.Type
+    TYPE_MANUAL: Backup.Type
+    ID_FIELD_NUMBER: _ClassVar[int]
+    PROJECT_ID_FIELD_NUMBER: _ClassVar[int]
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    CREATE_TIME_FIELD_NUMBER: _ClassVar[int]
+    START_TIME_FIELD_NUMBER: _ClassVar[int]
+    SOURCE_CLUSTER_ID_FIELD_NUMBER: _ClassVar[int]
+    SIZE_FIELD_NUMBER: _ClassVar[int]
+    TYPE_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    project_id: str
+    name: str
+    create_time: _timestamp_pb2.Timestamp
+    start_time: _timestamp_pb2.Timestamp
+    source_cluster_id: str
+    size: int
+    type: Backup.Type
+    def __init__(self, id: _Optional[str] = ..., project_id: _Optional[str] = ..., name: _Optional[str] = ..., create_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., start_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., source_cluster_id: _Optional[str] = ..., size: _Optional[int] = ..., type: _Optional[_Union[Backup.Type, str]] = ...) -> None: ...

doublecloud/clickhouse/v1/backup_service_pb2.pyi

@@ -0,0 +1,45 @@
+from doublecloud.v1 import operation_pb2 as _operation_pb2
+from doublecloud.v1 import paging_pb2 as _paging_pb2
+from doublecloud.clickhouse.v1 import backup_pb2 as _backup_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Iterable as _Iterable, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class GetBackupRequest(_message.Message):
+    __slots__ = ["backup_id"]
+    BACKUP_ID_FIELD_NUMBER: _ClassVar[int]
+    backup_id: str
+    def __init__(self, backup_id: _Optional[str] = ...) -> None: ...
+
+class ListBackupsRequest(_message.Message):
+    __slots__ = ["project_id", "paging"]
+    PROJECT_ID_FIELD_NUMBER: _ClassVar[int]
+    PAGING_FIELD_NUMBER: _ClassVar[int]
+    project_id: str
+    paging: _paging_pb2.Paging
+    def __init__(self, project_id: _Optional[str] = ..., paging: _Optional[_Union[_paging_pb2.Paging, _Mapping]] = ...) -> None: ...
+
+class ListBackupsResponse(_message.Message):
+    __slots__ = ["backups", "next_page"]
+    BACKUPS_FIELD_NUMBER: _ClassVar[int]
+    NEXT_PAGE_FIELD_NUMBER: _ClassVar[int]
+    backups: _containers.RepeatedCompositeFieldContainer[_backup_pb2.Backup]
+    next_page: _paging_pb2.NextPage
+    def __init__(self, backups: _Optional[_Iterable[_Union[_backup_pb2.Backup, _Mapping]]] = ..., next_page: _Optional[_Union[_paging_pb2.NextPage, _Mapping]] = ...) -> None: ...
+
+class CreateBackupRequest(_message.Message):
+    __slots__ = ["cluster_id", "name"]
+    CLUSTER_ID_FIELD_NUMBER: _ClassVar[int]
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    cluster_id: str
+    name: str
+    def __init__(self, cluster_id: _Optional[str] = ..., name: _Optional[str] = ...) -> None: ...
+
+class DeleteBackupRequest(_message.Message):
+    __slots__ = ["backup_id"]
+    BACKUP_ID_FIELD_NUMBER: _ClassVar[int]
+    backup_id: str
+    def __init__(self, backup_id: _Optional[str] = ...) -> None: ...

doublecloud/clickhouse/v1/cluster_pb2.pyi

@@ -0,0 +1,123 @@
+from google.protobuf import wrappers_pb2 as _wrappers_pb2
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from doublecloud.clickhouse.v1 import config_pb2 as _config_pb2
+from doublecloud.v1 import cluster_pb2 as _cluster_pb2
+from doublecloud.v1 import maintenance_pb2 as _maintenance_pb2
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from typing import ClassVar as _ClassVar, Mapping as _Mapping, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class Cluster(_message.Message):
+    __slots__ = ["id", "project_id", "cloud_type", "region_id", "create_time", "name", "description", "status", "version", "resources", "connection_info", "access", "private_connection_info", "encryption", "network_id", "clickhouse_config", "maintenance_window", "maintenance_operation"]
+    ID_FIELD_NUMBER: _ClassVar[int]
+    PROJECT_ID_FIELD_NUMBER: _ClassVar[int]
+    CLOUD_TYPE_FIELD_NUMBER: _ClassVar[int]
+    REGION_ID_FIELD_NUMBER: _ClassVar[int]
+    CREATE_TIME_FIELD_NUMBER: _ClassVar[int]
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    DESCRIPTION_FIELD_NUMBER: _ClassVar[int]
+    STATUS_FIELD_NUMBER: _ClassVar[int]
+    VERSION_FIELD_NUMBER: _ClassVar[int]
+    RESOURCES_FIELD_NUMBER: _ClassVar[int]
+    CONNECTION_INFO_FIELD_NUMBER: _ClassVar[int]
+    ACCESS_FIELD_NUMBER: _ClassVar[int]
+    PRIVATE_CONNECTION_INFO_FIELD_NUMBER: _ClassVar[int]
+    ENCRYPTION_FIELD_NUMBER: _ClassVar[int]
+    NETWORK_ID_FIELD_NUMBER: _ClassVar[int]
+    CLICKHOUSE_CONFIG_FIELD_NUMBER: _ClassVar[int]
+    MAINTENANCE_WINDOW_FIELD_NUMBER: _ClassVar[int]
+    MAINTENANCE_OPERATION_FIELD_NUMBER: _ClassVar[int]
+    id: str
+    project_id: str
+    cloud_type: str
+    region_id: str
+    create_time: _timestamp_pb2.Timestamp
+    name: str
+    description: str
+    status: _cluster_pb2.ClusterStatus
+    version: str
+    resources: ClusterResources
+    connection_info: ConnectionInfo
+    access: _cluster_pb2.Access
+    private_connection_info: PrivateConnectionInfo
+    encryption: _cluster_pb2.DataEncryption
+    network_id: str
+    clickhouse_config: _config_pb2.ClickhouseConfig
+    maintenance_window: _maintenance_pb2.MaintenanceWindow
+    maintenance_operation: _maintenance_pb2.MaintenanceOperation
+    def __init__(self, id: _Optional[str] = ..., project_id: _Optional[str] = ..., cloud_type: _Optional[str] = ..., region_id: _Optional[str] = ..., create_time: _Optional[_Union[_timestamp_pb2.Timestamp, _Mapping]] = ..., name: _Optional[str] = ..., description: _Optional[str] = ..., status: _Optional[_Union[_cluster_pb2.ClusterStatus, str]] = ..., version: _Optional[str] = ..., resources: _Optional[_Union[ClusterResources, _Mapping]] = ..., connection_info: _Optional[_Union[ConnectionInfo, _Mapping]] = ..., access: _Optional[_Union[_cluster_pb2.Access, _Mapping]] = ..., private_connection_info: _Optional[_Union[PrivateConnectionInfo, _Mapping]] = ..., encryption: _Optional[_Union[_cluster_pb2.DataEncryption, _Mapping]] = ..., network_id: _Optional[str] = ..., clickhouse_config: _Optional[_Union[_config_pb2.ClickhouseConfig, _Mapping]] = ..., maintenance_window: _Optional[_Union[_maintenance_pb2.MaintenanceWindow, _Mapping]] = ..., maintenance_operation: _Optional[_Union[_maintenance_pb2.MaintenanceOperation, _Mapping]] = ...) -> None: ...
+
+class ClusterResources(_message.Message):
+    __slots__ = ["clickhouse"]
+    class Clickhouse(_message.Message):
+        __slots__ = ["resource_preset_id", "disk_size", "replica_count", "shard_count"]
+        RESOURCE_PRESET_ID_FIELD_NUMBER: _ClassVar[int]
+        DISK_SIZE_FIELD_NUMBER: _ClassVar[int]
+        REPLICA_COUNT_FIELD_NUMBER: _ClassVar[int]
+        SHARD_COUNT_FIELD_NUMBER: _ClassVar[int]
+        resource_preset_id: str
+        disk_size: _wrappers_pb2.Int64Value
+        replica_count: _wrappers_pb2.Int64Value
+        shard_count: _wrappers_pb2.Int64Value
+        def __init__(self, resource_preset_id: _Optional[str] = ..., disk_size: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., replica_count: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., shard_count: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ...) -> None: ...
+    CLICKHOUSE_FIELD_NUMBER: _ClassVar[int]
+    clickhouse: ClusterResources.Clickhouse
+    def __init__(self, clickhouse: _Optional[_Union[ClusterResources.Clickhouse, _Mapping]] = ...) -> None: ...
+
+class ConnectionInfo(_message.Message):
+    __slots__ = ["host", "user", "password", "https_port", "tcp_port_secure", "native_protocol", "https_uri", "jdbc_uri", "odbc_uri"]
+    HOST_FIELD_NUMBER: _ClassVar[int]
+    USER_FIELD_NUMBER: _ClassVar[int]
+    PASSWORD_FIELD_NUMBER: _ClassVar[int]
+    HTTPS_PORT_FIELD_NUMBER: _ClassVar[int]
+    TCP_PORT_SECURE_FIELD_NUMBER: _ClassVar[int]
+    NATIVE_PROTOCOL_FIELD_NUMBER: _ClassVar[int]
+    HTTPS_URI_FIELD_NUMBER: _ClassVar[int]
+    JDBC_URI_FIELD_NUMBER: _ClassVar[int]
+    ODBC_URI_FIELD_NUMBER: _ClassVar[int]
+    host: str
+    user: str
+    password: str
+    https_port: _wrappers_pb2.Int64Value
+    tcp_port_secure: _wrappers_pb2.Int64Value
+    native_protocol: str
+    https_uri: str
+    jdbc_uri: str
+    odbc_uri: str
+    def __init__(self, host: _Optional[str] = ..., user: _Optional[str] = ..., password: _Optional[str] = ..., https_port: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., tcp_port_secure: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., native_protocol: _Optional[str] = ..., https_uri: _Optional[str] = ..., jdbc_uri: _Optional[str] = ..., odbc_uri: _Optional[str] = ...) -> None: ...
+
+class PrivateConnectionInfo(_message.Message):
+    __slots__ = ["host", "user", "password", "https_port", "tcp_port_secure", "native_protocol", "https_uri", "jdbc_uri", "odbc_uri"]
+    HOST_FIELD_NUMBER: _ClassVar[int]
+    USER_FIELD_NUMBER: _ClassVar[int]
+    PASSWORD_FIELD_NUMBER: _ClassVar[int]
+    HTTPS_PORT_FIELD_NUMBER: _ClassVar[int]
+    TCP_PORT_SECURE_FIELD_NUMBER: _ClassVar[int]
+    NATIVE_PROTOCOL_FIELD_NUMBER: _ClassVar[int]
+    HTTPS_URI_FIELD_NUMBER: _ClassVar[int]
+    JDBC_URI_FIELD_NUMBER: _ClassVar[int]
+    ODBC_URI_FIELD_NUMBER: _ClassVar[int]
+    host: str
+    user: str
+    password: str
+    https_port: _wrappers_pb2.Int64Value
+    tcp_port_secure: _wrappers_pb2.Int64Value
+    native_protocol: str
+    https_uri: str
+    jdbc_uri: str
+    odbc_uri: str
+    def __init__(self, host: _Optional[str] = ..., user: _Optional[str] = ..., password: _Optional[str] = ..., https_port: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., tcp_port_secure: _Optional[_Union[_wrappers_pb2.Int64Value, _Mapping]] = ..., native_protocol: _Optional[str] = ..., https_uri: _Optional[str] = ..., jdbc_uri: _Optional[str] = ..., odbc_uri: _Optional[str] = ...) -> None: ...
+
+class Host(_message.Message):
+    __slots__ = ["name", "cluster_id", "shard_name", "private_name"]
+    NAME_FIELD_NUMBER: _ClassVar[int]
+    CLUSTER_ID_FIELD_NUMBER: _ClassVar[int]
+    SHARD_NAME_FIELD_NUMBER: _ClassVar[int]
+    PRIVATE_NAME_FIELD_NUMBER: _ClassVar[int]
+    name: str
+    cluster_id: str
+    shard_name: str
+    private_name: str
+    def __init__(self, name: _Optional[str] = ..., cluster_id: _Optional[str] = ..., shard_name: _Optional[str] = ..., private_name: _Optional[str] = ...) -> None: ...