falconry/falcon

Advanced typing of ASGI `scope` dict

Open

#2,628 opened on 2026年4月25日

GitHub で見る
 (3 comments) (0 reactions) (0 assignees)Python (9,293 stars) (925 forks)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
Issue 種別
refactor
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
under 1 hour
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
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.