Use `ParamSpec` to type LRU cache decorators

描述

贡献者指南

技术栈

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.