Module

template.cached_blocks

Cached blocks dict wrapper for block cache optimization.

1Class

Classes

CachedBlocksDict 11 ▼
Dict wrapper that returns cached HTML for site-scoped blocks. Used by Kida's block cache optimizat…

Dict wrapper that returns cached HTML for site-scoped blocks.

Used by Kida's block cache optimization to intercept .get() calls from templates and return pre-rendered HTML for site-wide blocks (nav, footer, etc.).

Complexity: O(1) for lookups.

Methods

get 2 BlockCallable | Any ▼
Intercept .get() calls to return cached HTML when available.
def get(self, key: str, default: Any = None) -> BlockCallable | Any
Parameters
Name Type Description
key —
default — Default:None
Returns
BlockCallable | Any
setdefault 2 BlockCallable | Any ▼
Preserve setdefault() behavior for block registration. Kida templates use .set…
def setdefault(self, key: str, default: Any = None) -> BlockCallable | Any

Preserve setdefault() behavior for block registration.

Kida templates use .setdefault() to register their own block functions if not already overridden by a child template.

Parameters
Name Type Description
key —
default — Default:None
Returns
BlockCallable | Any
keys 0 set[str] ▼
Support .keys() iteration.
def keys(self) -> set[str]
Returns
set[str]
copy 0 dict[str, Any] ▼
Support .copy() for embed/include operations.
def copy(self) -> dict[str, Any]
Returns
dict[str, Any]
Internal Methods 7 ▼
__init__ 4 ▼
def __init__(self, original: dict[str, Any] | None, cached: dict[str, str], cached_names: frozenset[str] | set[str], stats: dict[str, int] | None = None)
Parameters
Name Type Description
original —
cached —
cached_names —
stats — Default:None
_make_wrapper 1 BlockCallable ▼
Create a block-signature wrapper returning cached HTML.
staticmethod
def _make_wrapper(html: str) -> BlockCallable
Parameters
Name Type Description
html —
Returns
BlockCallable
_record_hit 0 ▼
Record cache hit (thread-safe when stats shared).
def _record_hit(self) -> None
_record_miss 0 ▼
Record cache miss (thread-safe when stats shared).
def _record_miss(self) -> None
__getitem__ 1 BlockCallable | Any ▼
Support dict[key] access.
def __getitem__(self, key: str) -> BlockCallable | Any
Parameters
Name Type Description
key —
Returns
BlockCallable | Any
__setitem__ 2 ▼
Support dict[key] = value assignment.
def __setitem__(self, key: str, value: Any) -> None
Parameters
Name Type Description
key —
value —
__contains__ 1 bool ▼
Support 'key in dict' checks.
def __contains__(self, key: str) -> bool
Parameters
Name Type Description
key —
Returns
bool