falconry/falcon

Use `ParamSpec` to type LRU cache decorators

Open

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

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

描述

See here: https://github.com/falconry/falcon/pull/2599/changes#r2716854330.

Decorators like falcon.util.misc._lru_cache_* can be type using ParamSpec, allowing us to get rid of a bunch of typing ignores.

貢獻者指南

技術棧
python
領域
backenddeveloper experience
議題類型
refactor
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
3
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
1-3 hours
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
fresh
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
clear
前置要求
Python type hintsParamSpecFalcon internal utilities
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
70
研究方向
Examine the referenced PR #2599 changes to understand the current typing of ` lru cache *` decorators in `falcon/util/misc.py`. The goal is to replace `typing.Callable` or `typing.overload` with `ParamSpec` to preserve the type signature of the decorated function. Ensure all existing typing ignores are removed and that the new typing passes type checking.