feat: type more falcon modules

falcon/app.py

@@ -674,7 +674,7 @@ def add_static_route(
         self._static_routes.insert(0, (sr, sr, False))
         self._update_sink_and_static_routes()
 
-    def add_sink(self, sink: Callable, prefix: SinkPrefix = r'/'):
+    def add_sink(self, sink: Callable, prefix: SinkPrefix = r'/') -> None:
         """Register a sink method for the App.
 
         If no route matches a request, but the path in the requested URI

falcon/app_helpers.py

@@ -14,6 +14,8 @@
 
 """Utilities for the App class."""
 
+from __future__ import annotations
+
 from inspect import iscoroutinefunction
 from typing import IO, Iterable, List, Tuple
 
@@ -202,7 +204,7 @@ def prepare_middleware_ws(middleware: Iterable) -> Tuple[list, list]:
     return request_mw, resource_mw
 
 
-def default_serialize_error(req: Request, resp: Response, exception: HTTPError):
+def default_serialize_error(req: Request, resp: Response, exception: HTTPError) -> None:
     """Serialize the given instance of HTTPError.
 
     This function determines which of the supported media types, if
@@ -281,22 +283,22 @@ class CloseableStreamIterator:
         block_size (int): Number of bytes to read per iteration.
     """
 
-    def __init__(self, stream: IO, block_size: int):
+    def __init__(self, stream: IO, block_size: int) -> None:
         self._stream = stream
         self._block_size = block_size
 
-    def __iter__(self):
+    def __iter__(self) -> CloseableStreamIterator:
         return self
 
-    def __next__(self):
+    def __next__(self) -> bytes:
         data = self._stream.read(self._block_size)
 
         if data == b'':
             raise StopIteration
         else:
             return data
 
-    def close(self):
+    def close(self) -> None:
         try:
             self._stream.close()
         except (AttributeError, TypeError):

falcon/asgi_spec.py

@@ -14,6 +14,8 @@
 
 """Constants, etc. defined by the ASGI specification."""
 
+from __future__ import annotations
+
 
 class EventType:
     """Standard ASGI event type strings."""