falconry/falcon

Advanced typing of ASGI `scope` dict

Open

#2,628 建立於 2026年4月25日

在 GitHub 查看
 (3 留言) (0 反應) (0 負責人)Python (9,293 star) (925 fork)batch import
enhancementgood first issuetyping

描述

Create a more advanced TypedDict or similar for annotating ASGI scope.

We could probably draw inspiration from the relevant parts of asgiref: https://github.com/django/asgiref/blob/main/asgiref/typing.py. Since these annotations are really trivial, we probably want just to reimplement the part that we use.

This would allow us to get rid of a bunch of typing ignores, see #2599.

貢獻者指南

技術棧
python
領域
backendapi
議題類型
refactor
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
2
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
under 1 hour
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
Python type hintsASGI basicsTypedDict usage
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
70
研究方向
Look at the asgiref typing module linked in the issue (https://github.com/django/asgiref/blob/main/asgiref/typing.py) to understand the TypedDict structure for ASGI scope. Identify which parts of the scope are used in Falcon and create a custom TypedDict subclass. Then update type annotations in the codebase to use it, removing any '# type: ignore' comments. The issue references #2599 for context.