1  """WSGI-related types for static type checking"""
       2  
       3  from collections.abc import Callable, Iterable, Iterator
       4  from types import TracebackType
       5  from typing import Any, Protocol, TypeAlias
       6  
       7  __all__ = [
       8      "StartResponse",
       9      "WSGIEnvironment",
      10      "WSGIApplication",
      11      "InputStream",
      12      "ErrorStream",
      13      "FileWrapper",
      14  ]
      15  
      16  _ExcInfo: TypeAlias = tuple[type[BaseException], BaseException, TracebackType]
      17  _OptExcInfo: TypeAlias = _ExcInfo | tuple[None, None, None]
      18  
      19  class ESC[4;38;5;81mStartResponse(ESC[4;38;5;149mProtocol):
      20      """start_response() callable as defined in PEP 3333"""
      21      def __call__(
      22          self,
      23          status: str,
      24          headers: list[tuple[str, str]],
      25          exc_info: _OptExcInfo | None = ...,
      26          /,
      27      ) -> Callable[[bytes], object]: ...
      28  
      29  WSGIEnvironment: TypeAlias = dict[str, Any]
      30  WSGIApplication: TypeAlias = Callable[[WSGIEnvironment, StartResponse],
      31      Iterable[bytes]]
      32  
      33  class ESC[4;38;5;81mInputStream(ESC[4;38;5;149mProtocol):
      34      """WSGI input stream as defined in PEP 3333"""
      35      def read(self, size: int = ..., /) -> bytes: ...
      36      def readline(self, size: int = ..., /) -> bytes: ...
      37      def readlines(self, hint: int = ..., /) -> list[bytes]: ...
      38      def __iter__(self) -> Iterator[bytes]: ...
      39  
      40  class ESC[4;38;5;81mErrorStream(ESC[4;38;5;149mProtocol):
      41      """WSGI error stream as defined in PEP 3333"""
      42      def flush(self) -> object: ...
      43      def write(self, s: str, /) -> object: ...
      44      def writelines(self, seq: list[str], /) -> object: ...
      45  
      46  class ESC[4;38;5;81m_Readable(ESC[4;38;5;149mProtocol):
      47      def read(self, size: int = ..., /) -> bytes: ...
      48      # Optional: def close(self) -> object: ...
      49  
      50  class ESC[4;38;5;81mFileWrapper(ESC[4;38;5;149mProtocol):
      51      """WSGI file wrapper as defined in PEP 3333"""
      52      def __call__(
      53          self, file: _Readable, block_size: int = ..., /,
      54      ) -> Iterable[bytes]: ...