python/typeshed

grpc.aio.ServerInterceptor is incompatible with async RPC methods

Open

#15.495 aperta il 8 mar 2026

Vedi su GitHub
 (1 commento) (0 reazioni) (0 assegnatari)Python (1483 fork)batch import
help wantedstubs: false positive

Metriche repository

Star
 (3436 star)
Metriche merge PR
 (Merge medio 12g 21h) (66 PR mergiate in 30 g)

Descrizione

The grpc.aio.ServerInterceptor is currently annotated using grpc.RpcMethodHandler. However the interface for grpc.RpcMethodHandler is not compatible with async RPC methods. The correct stub for an async version would make use of Awaitable and AsyncIterator:

class RpcMethodHandler(abc.ABC, Generic[_TRequest, _TResponse]):
    request_streaming: bool
    response_streaming: bool

    # XXX: not clear from docs whether this is optional or not
    request_deserializer: _Deserializer[_TRequest] | None

    # XXX: not clear from docs whether this is optional or not
    response_serializer: _Serializer[_TResponse] | None

    unary_unary: Callable[[_TRequest, ServicerContext], Awaitable[_TResponse]] | None

    unary_stream: Callable[[_TRequest, ServicerContext], AsyncIterator[_TResponse]] | None

    stream_unary: Callable[[Iterator[_TRequest], ServicerContext], Awaitable[_TResponse]] | None

    stream_stream: Callable[[Iterator[_TRequest], ServicerContext], AsyncIterator[_TResponse]] | None

Guida contributor