basedpyright 1.31.7 → 1.32.0

package/dist/typeshed-fallback/stubs/docker/docker/transport/npipesocket.pyi

@@ -1,5 +1,7 @@
 import io
-from _typeshed import Incomplete
+from _typeshed import ReadableBuffer
+from typing import Any, Literal, NoReturn
+from typing_extensions import TypeAlias
 
 cERROR_PIPE_BUSY: int
 cSECURITY_SQOS_PRESENT: int
@@ -8,42 +10,48 @@ MAXIMUM_RETRY_COUNT: int
 
 def check_closed(f): ...
 
+_PyHANDLE: TypeAlias = Any  # pywin32._win32typing.PyHANDLE
+
 class NpipeSocket:
-    def __init__(self, handle=None) -> None: ...
+    def __init__(self, handle: _PyHANDLE | None = None) -> None: ...
     def accept(self) -> None: ...
     def bind(self, address) -> None: ...
     def close(self) -> None: ...
-    flags: Incomplete
-    def connect(self, address, retry_count: int = 0): ...
-    def connect_ex(self, address): ...
-    def detach(self): ...
-    def dup(self): ...
-    def getpeername(self): ...
-    def getsockname(self): ...
-    def getsockopt(self, level, optname, buflen=None) -> None: ...
-    def ioctl(self, control, option) -> None: ...
-    def listen(self, backlog) -> None: ...
-    def makefile(self, mode=None, bufsize=None): ...
-    def recv(self, bufsize, flags: int = 0): ...
-    def recvfrom(self, bufsize, flags: int = 0): ...
-    def recvfrom_into(self, buf, nbytes: int = 0, flags: int = 0): ...
-    def recv_into(self, buf, nbytes: int = 0): ...
-    def send(self, string, flags: int = 0): ...
-    def sendall(self, string, flags: int = 0): ...
-    def sendto(self, string, address): ...
-    def setblocking(self, flag): ...
-    def settimeout(self, value) -> None: ...
-    def gettimeout(self): ...
-    def setsockopt(self, level, optname, value) -> None: ...
-    def shutdown(self, how): ...
+    flags: int
+    def connect(self, address: str, retry_count: int = 0) -> None: ...
+    def connect_ex(self, address: str) -> None: ...
+    def detach(self) -> _PyHANDLE | None: ...
+    def dup(self) -> NpipeSocket: ...
+    def getpeername(self) -> str: ...
+    def getsockname(self) -> str: ...
+    # NotImplementedError
+    def getsockopt(self, level, optname, buflen=None) -> NoReturn: ...
+    # NotImplementedError
+    def ioctl(self, control, option) -> NoReturn: ...
+    # NotImplementedError
+    def listen(self, backlog) -> NoReturn: ...
+    def makefile(self, mode: str | None = None, bufsize: int | None = None) -> io.BufferedReader: ...
+    def recv(self, bufsize: int, flags: int = 0) -> str: ...
+    def recvfrom(self, bufsize: int, flags: int = 0) -> tuple[str, str]: ...
+    def recvfrom_into(self, buf: memoryview | ReadableBuffer, nbytes: int = 0, flags: int = 0) -> tuple[int, str]: ...
+    def recv_into(self, buf: memoryview | ReadableBuffer, nbytes: int = 0) -> int: ...
+    def send(self, string: str, flags: int = 0) -> int: ...
+    def sendall(self, string: str, flags: int = 0) -> int: ...
+    def sendto(self, string: str, address: str) -> int: ...
+    def setblocking(self, flag: bool) -> None: ...
+    def settimeout(self, value: float | None) -> None: ...
+    def gettimeout(self) -> int | None: ...
+    # NotImplementedError
+    def setsockopt(self, level, optname, value) -> NoReturn: ...
+    def shutdown(self, how) -> None: ...
 
 class NpipeFileIOBase(io.RawIOBase):
-    sock: Incomplete
-    def __init__(self, npipe_socket) -> None: ...
+    sock: NpipeSocket
+    def __init__(self, npipe_socket: NpipeSocket) -> None: ...
     def close(self) -> None: ...
     def fileno(self): ...
-    def isatty(self): ...
-    def readable(self): ...
-    def readinto(self, buf): ...
-    def seekable(self): ...
-    def writable(self): ...
+    def isatty(self) -> Literal[False]: ...
+    def readable(self) -> Literal[True]: ...
+    def readinto(self, buf: memoryview | ReadableBuffer) -> int: ...
+    def seekable(self) -> Literal[False]: ...
+    def writable(self) -> Literal[False]: ...

package/dist/typeshed-fallback/stubs/docker/docker/transport/sshconn.pyi

@@ -1,18 +1,20 @@
 import socket
-from _typeshed import Incomplete
+import subprocess
 
 import urllib3
 import urllib3.connection
 from docker.transport.basehttpadapter import BaseHTTPAdapter
+from paramiko import SSHClient, Transport
+from urllib3._collections import RecentlyUsedContainer as urllib3_RecentlyUsedContainer
 
-RecentlyUsedContainer: Incomplete
+RecentlyUsedContainer = urllib3_RecentlyUsedContainer
 
 class SSHSocket(socket.socket):
-    host: Incomplete
-    port: Incomplete
-    user: Incomplete
-    proc: Incomplete
-    def __init__(self, host) -> None: ...
+    host: str
+    port: str | None
+    user: str | None
+    proc: subprocess.Popen[bytes] | None
+    def __init__(self, host: str) -> None: ...
     def connect(self, **kwargs) -> None: ...  # type:ignore[override]
     def sendall(self, data) -> None: ...  # type:ignore[override]
     def send(self, data): ...  # type:ignore[override]
@@ -21,27 +23,31 @@ class SSHSocket(socket.socket):
     def close(self) -> None: ...
 
 class SSHConnection(urllib3.connection.HTTPConnection):
-    ssh_transport: Incomplete
-    timeout: Incomplete
-    ssh_host: Incomplete
-    def __init__(self, ssh_transport=None, timeout: int = 60, host=None) -> None: ...
-    sock: Incomplete
+    ssh_transport: Transport | None
+    timeout: int
+    ssh_host: str | None
+    def __init__(self, ssh_transport: Transport | None = None, timeout: int = 60, host: str | None = None) -> None: ...
+    sock: SSHSocket | None
     def connect(self) -> None: ...
 
 class SSHConnectionPool(urllib3.connectionpool.HTTPConnectionPool):
     scheme: str
-    ssh_transport: Incomplete
-    timeout: Incomplete
-    ssh_host: Incomplete
-    def __init__(self, ssh_client=None, timeout: int = 60, maxsize: int = 10, host=None) -> None: ...
+    ssh_transport: Transport | None
+    timeout: urllib3.Timeout
+    ssh_host: str | None
+    def __init__(
+        self, ssh_client: SSHClient | None = None, timeout: int = 60, maxsize: int = 10, host: str | None = None
+    ) -> None: ...
 
 class SSHHTTPAdapter(BaseHTTPAdapter):
-    __attrs__: Incomplete
-    ssh_client: Incomplete
-    ssh_host: Incomplete
-    timeout: Incomplete
-    max_pool_size: Incomplete
-    pools: Incomplete
-    def __init__(self, base_url, timeout: int = 60, pool_connections=25, max_pool_size=10, shell_out: bool = False) -> None: ...
-    def get_connection(self, url, proxies=None): ...
+    __attrs__: list[str]
+    ssh_client: SSHClient | None
+    ssh_host: str
+    timeout: int
+    max_pool_size: int
+    pools: int
+    def __init__(
+        self, base_url: str, timeout: int = 60, pool_connections: int = 25, max_pool_size: int = 10, shell_out: bool = False
+    ) -> None: ...
+    def get_connection(self, url: str | bytes, proxies=None) -> SSHConnectionPool: ...
     def close(self) -> None: ...

package/dist/typeshed-fallback/stubs/docker/docker/transport/unixconn.pyi

@@ -1,31 +1,34 @@
-from _typeshed import Incomplete
+import socket
 
 import urllib3
 import urllib3.connection
 from docker.transport.basehttpadapter import BaseHTTPAdapter
+from requests import PreparedRequest
+from urllib3._collections import RecentlyUsedContainer as urllib3_RecentlyUsedContainer
 
-RecentlyUsedContainer: Incomplete
+RecentlyUsedContainer = urllib3_RecentlyUsedContainer
 
 class UnixHTTPConnection(urllib3.connection.HTTPConnection):
-    base_url: Incomplete
-    unix_socket: Incomplete
-    timeout: Incomplete
-    def __init__(self, base_url, unix_socket, timeout: int = 60) -> None: ...
-    sock: Incomplete
+    base_url: str
+    unix_socket: str
+    timeout: int
+    def __init__(self, base_url: str, unix_socket: str, timeout: int = 60) -> None: ...
+    sock: socket.socket | None
     def connect(self) -> None: ...
 
 class UnixHTTPConnectionPool(urllib3.connectionpool.HTTPConnectionPool):
-    base_url: Incomplete
-    socket_path: Incomplete
-    timeout: Incomplete
-    def __init__(self, base_url, socket_path, timeout: int = 60, maxsize: int = 10) -> None: ...
+    base_url: str
+    socket_path: str
+    timeout: urllib3.Timeout
+    def __init__(self, base_url: str, socket_path: str, timeout: int = 60, maxsize: int = 10) -> None: ...
 
 class UnixHTTPAdapter(BaseHTTPAdapter):
-    __attrs__: Incomplete
-    socket_path: Incomplete
-    timeout: Incomplete
-    max_pool_size: Incomplete
-    pools: Incomplete
-    def __init__(self, socket_url, timeout: int = 60, pool_connections=25, max_pool_size=10) -> None: ...
-    def get_connection(self, url, proxies=None): ...
-    def request_url(self, request, proxies): ...
+    __attrs__: list[str]
+    socket_path: str
+    timeout: int
+    max_pool_size: int
+    pools: RecentlyUsedContainer
+    def __init__(self, socket_url: str, timeout: int = 60, pool_connections: int = 25, max_pool_size: int = 10) -> None: ...
+    def get_connection(self, url: bytes | str, proxies=None) -> UnixHTTPConnectionPool: ...
+    # proxies is unused
+    def request_url(self, request: PreparedRequest, proxies) -> str: ...

package/dist/typeshed-fallback/stubs/docker/docker/types/networks.pyi

@@ -5,7 +5,7 @@ class EndpointConfig(dict[str, Incomplete]):
     def __init__(
         self,
         version: str,
-        aliases: list[Incomplete] | None = None,
+        aliases: list[str] | None = None,
         links: dict[str, str] | dict[str, None] | dict[str, str | None] | Iterable[tuple[str, str | None]] | None = None,
         ipv4_address: str | None = None,
         ipv6_address: str | None = None,

package/dist/typeshed-fallback/stubs/docker/docker/types/services.pyi

@@ -1,6 +1,6 @@
 from _typeshed import Incomplete
 from collections.abc import Iterable, Mapping
-from typing import Final, Literal, TypeVar, overload
+from typing import Final, Literal, TypedDict, TypeVar, overload
 
 from .healthcheck import Healthcheck
 
@@ -36,12 +36,12 @@ class ContainerSpec(dict[str, Incomplete]):
         env: dict[str, Incomplete] | list[str] | None = None,
         workdir: str | None = None,
         user: str | None = None,
-        labels: dict[Incomplete, Incomplete] | None = None,
+        labels: dict[str, str] | None = None,
         mounts: Iterable[str | Mount] | None = None,
         stop_grace_period: int | None = None,
         secrets: list[SecretReference] | None = None,
         tty: bool | None = None,
-        groups: list[Incomplete] | None = None,
+        groups: list[str] | None = None,
         open_stdin: bool | None = None,
         read_only: bool | None = None,
         stop_signal: str | None = None,
@@ -52,9 +52,9 @@ class ContainerSpec(dict[str, Incomplete]):
         privileges: Privileges | None = None,
         isolation: str | None = None,
         init: bool | None = None,
-        cap_add: list[Incomplete] | None = None,
-        cap_drop: list[Incomplete] | None = None,
-        sysctls: dict[str, Incomplete] | None = None,
+        cap_add: list[str] | None = None,
+        cap_drop: list[str] | None = None,
+        sysctls: dict[str, str] | None = None,
     ) -> None: ...
 
 class Mount(dict[str, Incomplete]):
@@ -67,7 +67,7 @@ class Mount(dict[str, Incomplete]):
         consistency: Literal["default", "consistent", "cached", "delegated"] | None = None,
         propagation: str | None = None,
         no_copy: bool = False,
-        labels: dict[Incomplete, Incomplete] | None = None,
+        labels: dict[str, str] | None = None,
         driver_config: DriverConfig | None = None,
         tmpfs_size: int | str | None = None,
         tmpfs_mode: int | None = None,
@@ -75,6 +75,10 @@ class Mount(dict[str, Incomplete]):
     @classmethod
     def parse_mount_string(cls, string: str) -> Mount: ...
 
+class _ResourceDict(TypedDict):
+    Kind: str
+    Value: int
+
 class Resources(dict[str, Incomplete]):
     def __init__(
         self,
@@ -82,7 +86,9 @@ class Resources(dict[str, Incomplete]):
         mem_limit: int | None = None,
         cpu_reservation: int | None = None,
         mem_reservation: int | None = None,
-        generic_resources: dict[str, Incomplete] | list[str] | None = None,
+        generic_resources: (
+            dict[str, int | str] | list[dict[Literal["DiscreteResourceSpec", "NamedResourceSpec"], _ResourceDict]] | None
+        ) = None,
     ) -> None: ...
 
 class UpdateConfig(dict[str, Incomplete]):
@@ -110,7 +116,7 @@ class RestartPolicy(dict[str, Incomplete]):
     ) -> None: ...
 
 class DriverConfig(dict[str, Incomplete]):
-    def __init__(self, name: str, options: dict[Incomplete, Incomplete] | None = None) -> None: ...
+    def __init__(self, name: str, options: dict[str, str] | None = None) -> None: ...
 
 class EndpointSpec(dict[str, Incomplete]):
     def __init__(
@@ -185,4 +191,4 @@ class Privileges(dict[str, Incomplete]):
     ) -> None: ...
 
 class NetworkAttachmentConfig(dict[str, Incomplete]):
-    def __init__(self, target: str, aliases: list[str] | None = None, options: dict[str, Incomplete] | None = None) -> None: ...
+    def __init__(self, target: str, aliases: list[str] | None = None, options: dict[str, str] | None = None) -> None: ...

package/dist/typeshed-fallback/stubs/docker/docker/types/swarm.pyi

@@ -1,4 +1,3 @@
-from _typeshed import Incomplete
 from typing import Any
 
 from .services import DriverConfig
@@ -17,7 +16,7 @@ class SwarmSpec(dict[str, Any]):
         node_cert_expiry: int | None = None,
         external_cas: list[SwarmExternalCA] | None = None,
         name: str | None = None,
-        labels: dict[str, Incomplete] | None = None,
+        labels: dict[str, str] | None = None,
         signing_ca_cert: str | None = None,
         signing_ca_key: str | None = None,
         ca_force_rotate: int | None = None,
@@ -27,9 +26,5 @@ class SwarmSpec(dict[str, Any]):
 
 class SwarmExternalCA(dict[str, Any]):
     def __init__(
-        self,
-        url: str,
-        protocol: str | None = None,
-        options: dict[Incomplete, Incomplete] | None = None,
-        ca_cert: str | None = None,
+        self, url: str, protocol: str | None = None, options: dict[str, str] | None = None, ca_cert: str | None = None
     ) -> None: ...

package/dist/typeshed-fallback/stubs/docker/docker/utils/decorators.pyi

@@ -1,6 +1,10 @@
-from _typeshed import Incomplete
 from collections.abc import Callable
+from typing import TypeVar
+from typing_extensions import ParamSpec
 
-def check_resource(resource_name: str): ...
-def minimum_version(version: str): ...
-def update_headers(f: Callable[..., Incomplete]): ...
+_P = ParamSpec("_P")
+_R = TypeVar("_R")
+
+def check_resource(resource_name: str) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def minimum_version(version: str) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ...
+def update_headers(f: Callable[_P, _R]) -> Callable[_P, _R]: ...

package/dist/typeshed-fallback/stubs/docker/docker/utils/utils.pyi

@@ -1,5 +1,5 @@
 import datetime
-from _typeshed import FileDescriptorOrPath, Incomplete, ReadableBuffer
+from _typeshed import FileDescriptorOrPath, ReadableBuffer
 from collections.abc import Iterable, Mapping
 from shlex import _ShlexInstream
 from typing import Literal, NamedTuple, NoReturn, TypedDict, TypeVar, overload, type_check_only
@@ -38,7 +38,7 @@ def convert_port_bindings(
 @overload
 def convert_volume_binds(binds: list[_T]) -> list[_T]: ...
 @overload
-def convert_volume_binds(binds: Mapping[str | bytes, Incomplete]) -> list[str]: ...
+def convert_volume_binds(binds: Mapping[str | bytes, bytes | str | dict[str, bytes | str]]) -> list[str]: ...
 @overload
 def convert_tmpfs_mounts(tmpfs: dict[_K, _V]) -> dict[_K, _V]: ...
 @overload
@@ -56,8 +56,8 @@ def parse_host(
 ) -> Literal["http+unix:///var/run/docker.sock"]: ...
 @overload
 def parse_host(addr: str | None, is_win32: bool = False, tls: bool = False) -> str | bytes: ...
-def parse_devices(devices: Iterable[str | dict[str, Incomplete]]) -> list[dict[str, Incomplete]]: ...
-def kwargs_from_env(environment: Mapping[str, Incomplete] | None = None) -> _EnvKWArgs: ...
+def parse_devices(devices: Iterable[str | dict[str, str]]) -> list[dict[str, str]]: ...
+def kwargs_from_env(environment: Mapping[str, str] | None = None) -> _EnvKWArgs: ...
 def convert_filters(filters) -> str: ...
 def datetime_to_timestamp(dt: datetime.datetime) -> int: ...
 def parse_bytes(s: float | str) -> float: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/nodes.pyi

@@ -89,7 +89,7 @@ class Node:
     @overload
     def next_node(
         self, condition: type[_N], include_self: bool = False, descend: bool = True, siblings: bool = False, ascend: bool = False
-    ) -> _N: ...
+    ) -> _N | None: ...
     @overload
     def next_node(
         self,
@@ -98,7 +98,7 @@ class Node:
         descend: bool = True,
         siblings: bool = False,
         ascend: bool = False,
-    ) -> Node: ...
+    ) -> Node | None: ...
     def validate(self, recursive: bool = True) -> None: ...
     def validate_position(self) -> None: ...
 

package/dist/typeshed-fallback/stubs/flake8-rst-docstrings/METADATA.toml

@@ -1,2 +1,2 @@
-version = "0.3.*"
+version = "0.4.*"
 upstream_repository = "https://github.com/peterjc/flake8-rst-docstrings"

package/dist/typeshed-fallback/stubs/flake8-typing-imports/METADATA.toml

@@ -1,2 +1,2 @@
-version = "1.16.*"
+version = "1.17.*"
 upstream_repository = "https://github.com/asottile/flake8-typing-imports"

package/dist/typeshed-fallback/stubs/grpcio/grpc/__init__.pyi

@@ -76,13 +76,10 @@ def secure_channel(
 ) -> Channel: ...
 
 _Interceptor: TypeAlias = (
-    UnaryUnaryClientInterceptor[_TRequest, _TResponse]
-    | UnaryStreamClientInterceptor[_TRequest, _TResponse]
-    | StreamUnaryClientInterceptor[_TRequest, _TResponse]
-    | StreamStreamClientInterceptor[_TRequest, _TResponse]
+    UnaryUnaryClientInterceptor | UnaryStreamClientInterceptor | StreamUnaryClientInterceptor | StreamStreamClientInterceptor
 )
 
-def intercept_channel(channel: Channel, *interceptors: _Interceptor[_TRequest, _TResponse]) -> Channel: ...
+def intercept_channel(channel: Channel, *interceptors: _Interceptor) -> Channel: ...
 
 # Create Client Credentials:
 
@@ -108,8 +105,8 @@ def composite_channel_credentials(
 
 def server(
     thread_pool: futures.ThreadPoolExecutor,
-    handlers: list[GenericRpcHandler[Any, Any]] | None = None,
-    interceptors: list[ServerInterceptor[Any, Any]] | None = None,
+    handlers: list[GenericRpcHandler] | None = None,
+    interceptors: list[ServerInterceptor] | None = None,
     options: _Options | None = None,
     maximum_concurrent_rpcs: int | None = None,
     compression: Compression | None = None,
@@ -173,7 +170,7 @@ def stream_stream_rpc_method_handler(
 ) -> RpcMethodHandler[_TRequest, _TResponse]: ...
 def method_handlers_generic_handler(
     service: str, method_handlers: dict[str, RpcMethodHandler[Any, Any]]
-) -> GenericRpcHandler[Any, Any]: ...
+) -> GenericRpcHandler: ...
 
 # Channel Ready Future:
 
@@ -264,7 +261,7 @@ class Channel(abc.ABC):
 
 class Server(abc.ABC):
     @abc.abstractmethod
-    def add_generic_rpc_handlers(self, generic_rpc_handlers: Iterable[GenericRpcHandler[Any, Any]]) -> None: ...
+    def add_generic_rpc_handlers(self, generic_rpc_handlers: Iterable[GenericRpcHandler]) -> None: ...
 
     # Returns an integer port on which server will accept RPC requests.
     @abc.abstractmethod
@@ -378,25 +375,13 @@ class ClientCallDetails(abc.ABC):
 @type_check_only
 class _CallFuture(Call, Future[_TResponse], metaclass=abc.ABCMeta): ...
 
-class UnaryUnaryClientInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
+class UnaryUnaryClientInterceptor(abc.ABC):
+    # This method (not the class) is generic over _TRequest and _TResponse
+    # and the types must satisfy the no-op implementation of
+    # `return continuation(client_call_details, request)`.
     @abc.abstractmethod
     def intercept_unary_unary(
         self,
-        # FIXME: decode these cryptic runes to confirm the typing mystery of
-        # this callable's signature that was left for us by past civilisations:
-        #
-        #     continuation - A function that proceeds with the invocation by
-        #     executing the next interceptor in chain or invoking the actual RPC
-        #     on the underlying Channel. It is the interceptor's responsibility
-        #     to call it if it decides to move the RPC forward. The interceptor
-        #     can use response_future = continuation(client_call_details,
-        #     request) to continue with the RPC. continuation returns an object
-        #     that is both a Call for the RPC and a Future. In the event of RPC
-        #     completion, the return Call-Future's result value will be the
-        #     response message of the RPC. Should the event terminate with non-OK
-        #     status, the returned Call-Future's exception value will be an
-        #     RpcError.
-        #
         continuation: Callable[[ClientCallDetails, _TRequest], _CallFuture[_TResponse]],
         client_call_details: ClientCallDetails,
         request: _TRequest,
@@ -407,7 +392,10 @@ class _CallIterator(Call, Generic[_TResponse], metaclass=abc.ABCMeta):
     def __iter__(self) -> Iterator[_TResponse]: ...
     def __next__(self) -> _TResponse: ...
 
-class UnaryStreamClientInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
+class UnaryStreamClientInterceptor(abc.ABC):
+    # This method (not the class) is generic over _TRequest and _TResponse
+    # and the types must satisfy the no-op implementation of
+    # `return continuation(client_call_details, request)`.
     @abc.abstractmethod
     def intercept_unary_stream(
         self,
@@ -416,20 +404,26 @@ class UnaryStreamClientInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
         request: _TRequest,
     ) -> _CallIterator[_TResponse]: ...
 
-class StreamUnaryClientInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
+class StreamUnaryClientInterceptor(abc.ABC):
+    # This method (not the class) is generic over _TRequest and _TResponse
+    # and the types must satisfy the no-op implementation of
+    # `return continuation(client_call_details, request_iterator)`.
     @abc.abstractmethod
     def intercept_stream_unary(
         self,
-        continuation: Callable[[ClientCallDetails, _TRequest], _CallFuture[_TResponse]],
+        continuation: Callable[[ClientCallDetails, Iterator[_TRequest]], _CallFuture[_TResponse]],
         client_call_details: ClientCallDetails,
         request_iterator: Iterator[_TRequest],
     ) -> _CallFuture[_TResponse]: ...
 
-class StreamStreamClientInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
+class StreamStreamClientInterceptor(abc.ABC):
+    # This method (not the class) is generic over _TRequest and _TResponse
+    # and the types must satisfy the no-op implementation of
+    # `return continuation(client_call_details, request_iterator)`.
     @abc.abstractmethod
     def intercept_stream_stream(
         self,
-        continuation: Callable[[ClientCallDetails, _TRequest], _CallIterator[_TResponse]],
+        continuation: Callable[[ClientCallDetails, Iterator[_TRequest]], _CallIterator[_TResponse]],
         client_call_details: ClientCallDetails,
         request_iterator: Iterator[_TRequest],
     ) -> _CallIterator[_TResponse]: ...
@@ -493,17 +487,21 @@ class HandlerCallDetails(abc.ABC):
     method: str
     invocation_metadata: _Metadata
 
-class GenericRpcHandler(abc.ABC, Generic[_TRequest, _TResponse]):
+class GenericRpcHandler(abc.ABC):
+    # The return type depends on the handler call details.
     @abc.abstractmethod
-    def service(self, handler_call_details: HandlerCallDetails) -> RpcMethodHandler[_TRequest, _TResponse] | None: ...
+    def service(self, handler_call_details: HandlerCallDetails) -> RpcMethodHandler[Any, Any] | None: ...
 
-class ServiceRpcHandler(GenericRpcHandler[_TRequest, _TResponse], metaclass=abc.ABCMeta):
+class ServiceRpcHandler(GenericRpcHandler, metaclass=abc.ABCMeta):
     @abc.abstractmethod
     def service_name(self) -> str: ...
 
 # Service-Side Interceptor:
 
-class ServerInterceptor(abc.ABC, Generic[_TRequest, _TResponse]):
+class ServerInterceptor(abc.ABC):
+    # This method (not the class) is generic over _TRequest and _TResponse
+    # and the types must satisfy the no-op implementation of
+    # `return continuation(handler_call_details)`.
     @abc.abstractmethod
     def intercept_service(
         self,