beartype / plum / 34157530305

99%

push

github

perf(promotion): skip identity return conversions (#292)

Return annotations currently send every result through convert, even when
the fallback conversion simply checks the type and returns the object
unchanged. Cache these identity conversions by (type(obj), target_type) so
subsequent calls can bypass type-hint resolution and dispatch entirely.

Record both positive and negative results only when the fallback is faithful,
and invalidate the cache when conversion methods or global caches change.
Call resolved conversion methods directly to avoid the per-call wrapper created
by invoke.

Add regression and benchmark tests covering unions, Literal and
value-dependent checks, conversion registration, cache limits, and cache
invalidation. Annotated return calls improve by ~7.2×, with union returns
improving by ~14×.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>

24 of 24 new or added lines in 3 files covered. (100.0%)

1063 of 1070 relevant lines covered (99.35%)

6.73 hits per line