# Generated from soulfire/instance_live.proto. DO NOT EDIT.
# Generated by protoc-gen-connectrpc-py v0.13.0 with parameter "protobuf=google".
# ruff: noqa: PGH004
# ruff: noqa
# pyright: reportDeprecated=false
# ty: ignore[unused-ignore-comment]
# ty: ignore[deprecated, unused-ignore-comment]
# fmt: off
from __future__ import annotations
from typing import Protocol, TYPE_CHECKING
from connectrpc.client import ConnectClient, ConnectClientSync
from connectrpc.code import Code
from connectrpc.compat import google_protobuf_binary_codec, google_protobuf_codecs
from connectrpc.compression.gzip import GzipCompression
from connectrpc.errors import ConnectError
from connectrpc.method import IdempotencyLevel, MethodInfo, StreamType
from connectrpc.protocol import ProtocolType
from connectrpc.server import ConnectASGIApplication, ConnectWSGIApplication, DEFAULT_READ_MAX_BYTES, Endpoint, EndpointSync
from pyqwest import Client, SyncClient
from .instance_live_pb2 import InstanceEvent, WatchInstanceEventsRequest
if TYPE_CHECKING:
from collections.abc import AsyncGenerator, AsyncIterator, Iterable, Iterator, Mapping
from connectrpc.codec import Codec
from connectrpc.compression import Compression
from connectrpc.interceptor import Interceptor, InterceptorSync
from connectrpc.request import Headers, RequestContext
_DEFAULT_CODECS = google_protobuf_codecs()
_PROTO_BINARY_CODEC = google_protobuf_binary_codec()
_GZIP_COMPRESSION = GzipCompression()
[docs]
class InstanceLiveService(Protocol):
"""
Service for streaming instance-wide live events.
All operations require appropriate permissions.
"""
[docs]
def watch_instance_events(self, request: WatchInstanceEventsRequest, ctx: RequestContext[WatchInstanceEventsRequest, InstanceEvent], /) -> AsyncIterator[InstanceEvent]:
"""
Subscribes to a single multiplexed event stream covering every bot in the
instance. The stream stays open until the client cancels. Each selected
bot contributes its current status and live snapshots before incremental
events begin.
"""
raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
[docs]
class InstanceLiveServiceASGIApplication(ConnectASGIApplication[InstanceLiveService]):
def __init__(
self,
service: InstanceLiveService | AsyncGenerator[InstanceLiveService],
*,
interceptors: Iterable[Interceptor] = (),
read_max_bytes: int | None = DEFAULT_READ_MAX_BYTES,
compressions: Iterable[Compression] | None = None,
codecs: Iterable[Codec] | None = _DEFAULT_CODECS,
) -> None:
super().__init__(
service=service,
endpoints=lambda svc: {
"/soulfire.v1.InstanceLiveService/WatchInstanceEvents": Endpoint.server_stream(
method=MethodInfo(
name="WatchInstanceEvents",
service_name="soulfire.v1.InstanceLiveService",
input=WatchInstanceEventsRequest,
output=InstanceEvent,
idempotency_level=IdempotencyLevel.UNKNOWN,
stream_type=StreamType.SERVER_STREAM,
),
function=svc.watch_instance_events,
),
},
interceptors=interceptors,
read_max_bytes=read_max_bytes,
compressions=compressions,
codecs=codecs,
)
@property
def path(self) -> str:
"""Returns the URL path to mount the application to when serving multiple applications."""
return "/soulfire.v1.InstanceLiveService"
[docs]
class InstanceLiveServiceClient(ConnectClient):
"""
Service for streaming instance-wide live events.
All operations require appropriate permissions.
"""
def __init__(
self,
address: str,
*,
codec: Codec | None = _PROTO_BINARY_CODEC,
protocol: ProtocolType = ProtocolType.CONNECT,
accept_compression: Iterable[Compression] | None = None,
send_compression: Compression | None = _GZIP_COMPRESSION,
timeout_ms: int | None = None,
read_max_bytes: int | None = None,
interceptors: Iterable[Interceptor] = (),
http_client: Client | None = None,
) -> None:
super().__init__(
address=address,
codec=codec,
protocol=protocol,
accept_compression=accept_compression,
send_compression=send_compression,
timeout_ms=timeout_ms,
read_max_bytes=read_max_bytes,
interceptors=interceptors,
http_client=http_client,
)
[docs]
def watch_instance_events(
self,
request: WatchInstanceEventsRequest,
*,
headers: Headers | Mapping[str, str] | None = None,
timeout_ms: int | None = None,
) -> AsyncIterator[InstanceEvent]:
"""
Subscribes to a single multiplexed event stream covering every bot in the
instance. The stream stays open until the client cancels. Each selected
bot contributes its current status and live snapshots before incremental
events begin.
"""
return self.execute_server_stream(
request=request,
method=MethodInfo(
name="WatchInstanceEvents",
service_name="soulfire.v1.InstanceLiveService",
input=WatchInstanceEventsRequest,
output=InstanceEvent,
idempotency_level=IdempotencyLevel.UNKNOWN,
stream_type=StreamType.SERVER_STREAM,
),
headers=headers,
timeout_ms=timeout_ms,
)
[docs]
class InstanceLiveServiceSync(Protocol):
"""
Service for streaming instance-wide live events.
All operations require appropriate permissions.
"""
[docs]
def watch_instance_events(self, request: WatchInstanceEventsRequest, ctx: RequestContext[WatchInstanceEventsRequest, InstanceEvent], /) -> Iterator[InstanceEvent]:
"""
Subscribes to a single multiplexed event stream covering every bot in the
instance. The stream stays open until the client cancels. Each selected
bot contributes its current status and live snapshots before incremental
events begin.
"""
raise ConnectError(Code.UNIMPLEMENTED, 'Not implemented')
[docs]
class InstanceLiveServiceWSGIApplication(ConnectWSGIApplication):
def __init__(
self,
service: InstanceLiveServiceSync,
interceptors: Iterable[InterceptorSync] = (),
read_max_bytes: int | None = DEFAULT_READ_MAX_BYTES,
compressions: Iterable[Compression] | None = None,
codecs: Iterable[Codec] | None = _DEFAULT_CODECS,
) -> None:
super().__init__(
endpoints={
"/soulfire.v1.InstanceLiveService/WatchInstanceEvents": EndpointSync.server_stream(
method=MethodInfo(
name="WatchInstanceEvents",
service_name="soulfire.v1.InstanceLiveService",
input=WatchInstanceEventsRequest,
output=InstanceEvent,
idempotency_level=IdempotencyLevel.UNKNOWN,
stream_type=StreamType.SERVER_STREAM,
),
function=service.watch_instance_events,
),
},
interceptors=interceptors,
read_max_bytes=read_max_bytes,
compressions=compressions,
codecs=codecs,
)
@property
def path(self) -> str:
"""Returns the URL path to mount the application to when serving multiple applications."""
return "/soulfire.v1.InstanceLiveService"
[docs]
class InstanceLiveServiceClientSync(ConnectClientSync):
"""
Service for streaming instance-wide live events.
All operations require appropriate permissions.
"""
def __init__(
self,
address: str,
*,
codec: Codec | None = _PROTO_BINARY_CODEC,
protocol: ProtocolType = ProtocolType.CONNECT,
accept_compression: Iterable[Compression] | None = None,
send_compression: Compression | None = _GZIP_COMPRESSION,
timeout_ms: int | None = None,
read_max_bytes: int | None = None,
interceptors: Iterable[InterceptorSync] = (),
http_client: SyncClient | None = None,
) -> None:
super().__init__(
address=address,
codec=codec,
protocol=protocol,
accept_compression=accept_compression,
send_compression=send_compression,
timeout_ms=timeout_ms,
read_max_bytes=read_max_bytes,
interceptors=interceptors,
http_client=http_client,
)
[docs]
def watch_instance_events(
self,
request: WatchInstanceEventsRequest,
*,
headers: Headers | Mapping[str, str] | None = None,
timeout_ms: int | None = None,
) -> Iterator[InstanceEvent]:
"""
Subscribes to a single multiplexed event stream covering every bot in the
instance. The stream stays open until the client cancels. Each selected
bot contributes its current status and live snapshots before incremental
events begin.
"""
return self.execute_server_stream(
request=request,
method=MethodInfo(
name="WatchInstanceEvents",
service_name="soulfire.v1.InstanceLiveService",
input=WatchInstanceEventsRequest,
output=InstanceEvent,
idempotency_level=IdempotencyLevel.UNKNOWN,
stream_type=StreamType.SERVER_STREAM,
),
headers=headers,
timeout_ms=timeout_ms,
)