falconry/falcon

Use `ParamSpec` to type LRU cache decorators

Open

#2,629 opened on Apr 25, 2026

View on GitHubContributor guide
 (5 comments) (0 reactions) (0 assignees)Python (925 forks)batch import
enhancementgood first issuetyping

Repository metrics

Stars
 (9,293 stars)
PR merge metrics
 (PR metrics pending)

Description

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.

Contributor guide

Research direction
Examine the ` lru cache *` decorator functions in `falcon/util/misc.py` and apply `ParamSpec` to properly type them, removing existing `# type: ignore` comments.
Tech stack
python
Domain
backend
Issue type
Refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
Python typingParamSpec
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
60