🧪 Integrate flake8-typing-as-t into linting

The `_t` imported name has been chosen to ensure `typing` isn't
exposed as a public importable in every module.

Author: webknjaz

.flake8

@@ -106,6 +106,11 @@ per-file-ignores =
   # WPS226 Found string literal over-use: %s%s> %s > 3
   toxfile.py: WPS202, WPS226
 
+  # NOTE: Python stub files don't need most of the linting checks, only
+  # NOTE: `flake8-typing-as-t` is important.
+  # FIXME: Re-enable some checks gradually.
+  **/**.pyi: E, LN, WPS
+
   # There are multiple `assert`s (S101)
   # and subprocesses (import – S404; call – S603) in tests:
   cheroot/test/test_*.py: S101, S404, S603
@@ -169,6 +174,10 @@ pytest-parametrize-values-row-type = tuple
 # PT023:
 pytest-mark-no-parentheses = true
 
+# flake8-typing-as-t
+# TYT02:
+typing-as-t-imported-name = _t
+
 # wemake-python-styleguide
 show-source = true
 show-violation-links = true

.pre-commit-config.yaml

@@ -187,7 +187,12 @@ repos:
     - flake8-logging-format ~= 2024.24.12
     - flake8-pytest-style ~= 2.2.0
     - flake8-spellcheck ~= 0.28.0
+    - flake8-typing-as-t ~= 1.1.0
     - wemake-python-styleguide ~= 1.4.0
+    types: []
+    types_or:
+    - python
+    - pyi
 
     # `flake8-logging-format` is incompatible with Python 3.12+
     # * https://github.com/globality-corp/flake8-logging-format/issues/80

cheroot/_compat.pyi

@@ -1,9 +1,11 @@
-from typing import ContextManager, Optional, Type, Union
+import typing as _t
 
-def suppress(*exceptions: Type[BaseException]) -> ContextManager[None]: ...
+def suppress(
+    *exceptions: _t.Type[BaseException],
+) -> _t.ContextManager[None]: ...
 
-IS_ABOVE_OPENSSL10: Optional[bool]
-IS_ABOVE_OPENSSL31: Union[bool, None]
+IS_ABOVE_OPENSSL10: bool | None
+IS_ABOVE_OPENSSL31: bool | None
 IS_CI: bool
 IS_GITHUB_ACTIONS_WORKFLOW: bool
 IS_PYPY: bool
@@ -19,4 +21,4 @@ def ntob(n: str, encoding: str = ...) -> bytes: ...
 def ntou(n: str, encoding: str = ...) -> str: ...
 def bton(b: bytes, encoding: str = ...) -> str: ...
 def assert_native(n: str) -> None: ...
-def extract_bytes(mv: Union[memoryview, bytes]) -> bytes: ...
+def extract_bytes(mv: memoryview | bytes) -> bytes: ...

cheroot/cli.pyi

@@ -1,29 +1,29 @@
-from typing import Any
+import typing as _t
 
 class BindLocation: ...
 
 class TCPSocket(BindLocation):
-    bind_addr: Any
+    bind_addr: _t.Any
     def __init__(self, address, port) -> None: ...
 
 class UnixSocket(BindLocation):
-    bind_addr: Any
+    bind_addr: _t.Any
     def __init__(self, path) -> None: ...
 
 class AbstractSocket(BindLocation):
-    bind_addr: Any
+    bind_addr: _t.Any
     def __init__(self, abstract_socket) -> None: ...
 
 class Application:
     @classmethod
     def resolve(cls, full_path): ...
-    wsgi_app: Any
+    wsgi_app: _t.Any
     def __init__(self, wsgi_app) -> None: ...
     def server_args(self, parsed_args): ...
     def server(self, parsed_args): ...
 
 class GatewayYo:
-    gateway: Any
+    gateway: _t.Any
     def __init__(self, gateway) -> None: ...
     def server(self, parsed_args): ...
 

cheroot/connections.pyi

@@ -1,4 +1,4 @@
-from typing import Any
+import typing as _t
 
 IS_WINDOWS: bool
 
@@ -9,13 +9,13 @@ class _ThreadsafeSelector:
     def __len__(self): ...
     @property
     def connections(self) -> None: ...
-    def register(self, fileobj, events, data: Any | None = ...): ...
+    def register(self, fileobj, events, data: _t.Any | None = ...): ...
     def unregister(self, fileobj): ...
-    def select(self, timeout: Any | None = ...): ...
+    def select(self, timeout: _t.Any | None = ...): ...
     def close(self) -> None: ...
 
 class ConnectionManager:
-    server: Any
+    server: _t.Any
     def __init__(self, server) -> None: ...
     def put(self, conn) -> None: ...
     def stop(self) -> None: ...

cheroot/errors.pyi

@@ -1,13 +1,13 @@
-from typing import List, Set, Tuple, Type
+import typing as _t
 
 class MaxSizeExceeded(Exception): ...
 class NoSSLError(Exception): ...
 class FatalSSLAlert(Exception): ...
 
-def plat_specific_errors(*errnames: str) -> List[int]: ...
+def plat_specific_errors(*errnames: str) -> list[int]: ...
 
-socket_error_eintr: List[int]
-socket_errors_to_ignore: List[int]
-socket_errors_nonblocking: List[int]
-acceptable_sock_shutdown_error_codes: Set[int]
-acceptable_sock_shutdown_exceptions: Tuple[Type[Exception], ...]
+socket_error_eintr: list[int]
+socket_errors_to_ignore: list[int]
+socket_errors_nonblocking: list[int]
+acceptable_sock_shutdown_error_codes: set[int]
+acceptable_sock_shutdown_exceptions: tuple[_t.Type[Exception], ...]

cheroot/server.pyi

@@ -1,4 +1,4 @@
-from typing import Any
+import typing as _t
 
 __all__ = (
     'ChunkedRFile',
@@ -14,81 +14,81 @@ __all__ = (
 )
 
 class HeaderReader:
-    def __call__(self, rfile, hdict: Any | None = ...): ...
+    def __call__(self, rfile, hdict: _t.Any | None = ...): ...
 
 class DropUnderscoreHeaderReader(HeaderReader): ...
 
 class SizeCheckWrapper:
-    rfile: Any
-    maxlen: Any
+    rfile: _t.Any
+    maxlen: _t.Any
     bytes_read: int
     def __init__(self, rfile, maxlen) -> None: ...
-    def read(self, size: Any | None = ...): ...
-    def readline(self, size: Any | None = ...): ...
+    def read(self, size: _t.Any | None = ...): ...
+    def readline(self, size: _t.Any | None = ...): ...
     def readlines(self, sizehint: int = ...): ...
     def close(self) -> None: ...
     def __iter__(self): ...
     def __next__(self): ...
-    next: Any
+    next: _t.Any
 
 class KnownLengthRFile:
-    rfile: Any
-    remaining: Any
+    rfile: _t.Any
+    remaining: _t.Any
     def __init__(self, rfile, content_length) -> None: ...
-    def read(self, size: Any | None = ...): ...
-    def readline(self, size: Any | None = ...): ...
+    def read(self, size: _t.Any | None = ...): ...
+    def readline(self, size: _t.Any | None = ...): ...
     def readlines(self, sizehint: int = ...): ...
     def close(self) -> None: ...
     def __iter__(self): ...
     def __next__(self): ...
-    next: Any
+    next: _t.Any
 
 class ChunkedRFile:
-    rfile: Any
-    maxlen: Any
+    rfile: _t.Any
+    maxlen: _t.Any
     bytes_read: int
-    buffer: Any
-    bufsize: Any
+    buffer: _t.Any
+    bufsize: _t.Any
     closed: bool
     def __init__(self, rfile, maxlen, bufsize: int = ...) -> None: ...
-    def read(self, size: Any | None = ...): ...
-    def readline(self, size: Any | None = ...): ...
+    def read(self, size: _t.Any | None = ...): ...
+    def readline(self, size: _t.Any | None = ...): ...
     def readlines(self, sizehint: int = ...): ...
     def read_trailer_lines(self) -> None: ...
     def close(self) -> None: ...
 
 class HTTPRequest:
-    server: Any
-    conn: Any
-    inheaders: Any
-    outheaders: Any
+    server: _t.Any
+    conn: _t.Any
+    inheaders: _t.Any
+    outheaders: _t.Any
     ready: bool
     close_connection: bool
     chunked_write: bool
-    header_reader: Any
+    header_reader: _t.Any
     started_request: bool
     scheme: bytes
     response_protocol: str
     status: str
     sent_headers: bool
     chunked_read: bool
-    proxy_mode: Any
-    strict_mode: Any
+    proxy_mode: _t.Any
+    strict_mode: _t.Any
     def __init__(
         self,
         server,
         conn,
         proxy_mode: bool = ...,
         strict_mode: bool = ...,
     ) -> None: ...
-    rfile: Any
+    rfile: _t.Any
     def parse_request(self) -> None: ...
-    uri: Any
-    method: Any
-    authority: Any
-    path: Any
-    qs: Any
-    request_protocol: Any
+    uri: _t.Any
+    method: _t.Any
+    authority: _t.Any
+    path: _t.Any
+    qs: _t.Any
+    request_protocol: _t.Any
     def read_request_line(self): ...
     def read_request_headers(self): ...
     def respond(self) -> None: ...
@@ -98,19 +98,19 @@ class HTTPRequest:
     def send_headers(self) -> None: ...
 
 class HTTPConnection:
-    remote_addr: Any
-    remote_port: Any
-    ssl_env: Any
-    rbufsize: Any
-    wbufsize: Any
-    RequestHandlerClass: Any
+    remote_addr: _t.Any
+    remote_port: _t.Any
+    ssl_env: _t.Any
+    rbufsize: _t.Any
+    wbufsize: _t.Any
+    RequestHandlerClass: _t.Any
     peercreds_enabled: bool
     peercreds_resolve_enabled: bool
-    last_used: Any
-    server: Any
-    socket: Any
-    rfile: Any
-    wfile: Any
+    last_used: _t.Any
+    server: _t.Any
+    socket: _t.Any
+    rfile: _t.Any
+    wfile: _t.Any
     requests_seen: int
     def __init__(self, server, sock, makefile=...) -> None: ...
     def communicate(self): ...
@@ -130,48 +130,48 @@ class HTTPConnection:
     def peer_group(self): ...
 
 class HTTPServer:
-    gateway: Any
-    minthreads: Any
-    maxthreads: Any
-    server_name: Any
+    gateway: _t.Any
+    minthreads: _t.Any
+    maxthreads: _t.Any
+    server_name: _t.Any
     protocol: str
     request_queue_size: int
     shutdown_timeout: int
     timeout: int
     expiration_interval: float
-    version: Any
-    software: Any
+    version: _t.Any
+    software: _t.Any
     ready: bool
     max_request_header_size: int
     max_request_body_size: int
     nodelay: bool
-    ConnectionClass: Any
-    ssl_adapter: Any
+    ConnectionClass: _t.Any
+    ssl_adapter: _t.Any
     peercreds_enabled: bool
     peercreds_resolve_enabled: bool
     reuse_port: bool
     keep_alive_conn_limit: int
-    requests: Any
+    requests: _t.Any
     def __init__(
         self,
         bind_addr,
         gateway,
         minthreads: int = ...,
         maxthreads: int = ...,
-        server_name: Any | None = ...,
+        server_name: _t.Any | None = ...,
         peercreds_enabled: bool = ...,
         peercreds_resolve_enabled: bool = ...,
         reuse_port: bool = ...,
     ) -> None: ...
-    stats: Any
+    stats: _t.Any
     def clear_stats(self): ...
     def runtime(self): ...
     @property
     def bind_addr(self): ...
     @bind_addr.setter
     def bind_addr(self, value) -> None: ...
     def safe_start(self) -> None: ...
-    socket: Any
+    socket: _t.Any
     def prepare(self) -> None: ...
     def serve(self) -> None: ...
     def start(self) -> None: ...
@@ -211,7 +211,7 @@ class HTTPServer:
     def stop(self) -> None: ...
 
 class Gateway:
-    req: Any
+    req: _t.Any
     def __init__(self, req) -> None: ...
     def respond(self) -> None: ...
 

cheroot/ssl/__init__.pyi

@@ -1,20 +1,20 @@
+import typing as _t
 from abc import ABC, abstractmethod
-from typing import Any
 
 class Adapter(ABC):
-    certificate: Any
-    private_key: Any
-    certificate_chain: Any
-    ciphers: Any
+    certificate: _t.Any
+    private_key: _t.Any
+    certificate_chain: _t.Any
+    ciphers: _t.Any
     private_key_password: str | bytes | None
-    context: Any
+    context: _t.Any
     @abstractmethod
     def __init__(
         self,
         certificate,
         private_key,
-        certificate_chain: Any | None = ...,
-        ciphers: Any | None = ...,
+        certificate_chain: _t.Any | None = ...,
+        ciphers: _t.Any | None = ...,
         *,
         private_key_password: str | bytes | None = ...,
     ): ...