cache.deferred

Page actions AI-ready formats and sharing
Open LLM text
Share with AI
Ask Claude Ask ChatGPT Ask Gemini Ask Copilot

Deferred-value cache for Suspense context values.

DeferredCachestores successful async factory results behind explicit app or route-owned cache instances. On a warm hit it returns the cached value directly; on a miss…

Deferred-value cache for Suspense context values.

DeferredCachestores successful async factory results behind explicit app or route-owned cache instances. On a warm hit it returns the cached value directly; on a miss it returns an awaitable that resolves and stores the value.

cache.deferred

Name Type Default Description
type
qualified_name
element_type
description
source_file
line_number
is_autodoc
autodoc_element
_autodoc_template
_autodoc_url_path
_autodoc_page_type
title
doc_content_hash

Symbols on this page

_CachedValue
class
_SharedDeferred
class

Awaitable shared by all consumers for one in-flight cache key.

DeferredCache
class

Small explicit TTL cache for Suspense deferred values.

Use one cache instance per app, service, or route module. The cache stores successful factory results only. Warm hits return the value synchronously, soSuspenserenders that value in the initial shell. Misses return an awaitable, preserving the existing shell-plus-deferred-OOB Suspense path.

View source · /home/runner/work/chirp/chirp/site/../src/chirp/cache/deferred.py:1