Module

environment.filters._misc

Miscellaneous filters for Kida templates.

Functions

_filter_get 3 Any
Safe dictionary/object access that avoids Python method name conflicts. When a…
def _filter_get(value: Any, key: str, default: Any = None) -> Any

Safe dictionary/object access that avoids Python method name conflicts.

When accessing dict keys like 'items', 'keys', 'values', or 'get', using dotted access (e.g.,schema.items) returns the method, not the key value. This filter provides clean syntax for safe key access.

Parameters
Name Type Description
value Any

Dict, object, or None to access

key str

Key or attribute name to access

default Any

Value to return if key doesn't exist (default: None)

Default:None
Returns
Any
_filter_date 2 str
Format datetime, date, or epoch timestamp with strftime.
def _filter_date(value: Any, format: str = '%Y-%m-%d') -> str
Parameters
Name Type Description
value Any
format str Default:'%Y-%m-%d'
Returns
str
_filter_urlencode 1 str
URL-encode a string.
def _filter_urlencode(value: str) -> str
Parameters
Name Type Description
value str
Returns
str
_filter_random 1 Any
Return a random item from the sequence. Warning: This filter is impure (non-de…
def _filter_random(value: Any) -> Any

Return a random item from the sequence.

Warning: This filter is impure (non-deterministic).

Parameters
Name Type Description
value Any

A sequence to pick from.

Returns
Any
_filter_shuffle 1 list[Any]
Return a shuffled copy of the sequence. Warning: This filter is impure (non-de…
def _filter_shuffle(value: Any) -> list[Any]

Return a shuffled copy of the sequence.

Warning: This filter is impure (non-deterministic).

Parameters
Name Type Description
value Any

A sequence to shuffle.

Returns
list[Any]
_filter_classes 1 str
Join a list of CSS class names, dropping falsy values. **Handles:** - None val…
def _filter_classes(value: Any) -> str

Join a list of CSS class names, dropping falsy values.

Handles:

  • None values (dropped)
  • Empty strings (dropped)
  • False / 0 (dropped)
  • Nested lists (flattened one level)
Parameters
Name Type Description
value Any
Returns
str