GitHub

StreamRpc

API reference for StreamRpc.

An RPC with a payload P succeeding with a stream of A items that fails with E (Tag as in Rpc).

Functions

__init__

__init__(tag, payload_schema, success_schema, error_schema, defect_schema, annotations=Context.empty(), middlewares=()) -> None
ParameterTypeDescription
tagstr
payload_schemaTop
success_schemaTop
error_schemaTop
defect_schemaTop
annotationsContext[Any] = Context.empty()
middlewarestuple[AnyMiddleware, ...] = ()

middleware

middleware[T: RpcMiddleware[Any, Any, Any]](middleware) -> StreamRpc[P_co, A_co, E_co, M_co | T, MT_co | T, Tag_co]

This RPC wrapped by middleware (see Rpc.middleware).

ParameterTypeDescription
middlewaretype[T]

Returns StreamRpc[P_co, A_co, E_co, M_co | T, MT_co | T, Tag_co]

def middleware[T: RpcMiddleware[Any, Any, Any]](
    self, middleware: type[T], /
) -> StreamRpc[P_co, A_co, E_co, M_co | T, MT_co | T, Tag_co]:
    """This RPC wrapped by ``middleware`` (see ``Rpc.middleware``)."""
    return self.with_middleware(middleware)

set_payload

set_payload[P1](schema) -> StreamRpc[P1, A_co, E_co, M_co, MT_co, Tag_co]
ParameterTypeDescription
schemaCodec[P1, Any, Never, Never]

Returns StreamRpc[P1, A_co, E_co, M_co, MT_co, Tag_co]

def set_payload[P1](
    self, schema: Codec[P1, Any, Never, Never], /
) -> StreamRpc[P1, A_co, E_co, M_co, MT_co, Tag_co]:
    return replace(self, payload_schema=schema.__codec__())  # pyright: ignore[reportReturnType]

prefix

prefix(prefix) -> StreamRpc[P_co, A_co, E_co, M_co, MT_co]

This RPC with prefix before its tag (see Rpc.prefix).

ParameterTypeDescription
prefixstr

Returns StreamRpc[P_co, A_co, E_co, M_co, MT_co]

def prefix(self, prefix: str) -> StreamRpc[P_co, A_co, E_co, M_co, MT_co]:
    """This RPC with ``prefix`` before its tag (see ``Rpc.prefix``)."""
    return replace(self, tag=prefix + self.tag)

annotate

annotate[A, T](tag, value) -> Self
ParameterTypeDescription
tagTagLike[A, T]
valueA

Returns Self

def annotate[A, T](self, tag: TagLike[A, T], value: A) -> Self:
    return replace(self, annotations=self.annotations.add(tag, value))

annotate_merge

annotate_merge(annotations) -> Self
ParameterTypeDescription
annotationsContext[Any]

Returns Self

def annotate_merge(self, annotations: Context[Any]) -> Self:
    return replace(self, annotations=self.annotations.merge(annotations))

with_middleware

with_middleware(middleware) -> Self

This RPC wrapped by middleware (untyped: middleware types it).

ParameterTypeDescription
middlewareAnyMiddleware

Returns Self

def with_middleware(self, middleware: AnyMiddleware) -> Self:
    """This RPC wrapped by ``middleware`` (untyped: ``middleware`` types it)."""
    if middleware in self.middlewares:
        return self
    return replace(self, middlewares=(*self.middlewares, middleware))

pipe

pipe[B](f) -> B
ParameterTypeDescription
fCallable[[Self], B]

Returns B

def pipe[B](self, f: Callable[[Self], B], /) -> B:
    return f(self)