Module

templating.filters

Built-in chirp template filters.

These are web-framework-specific filters auto-registered on every chirp kida Environment. They complement Kida's built-in filters with patterns common in server-rendered HTML + htmx apps.

5Functions

Functions

field_errors 2 list[str] ▼
Extract validation errors for a single form field. Safely navigates a ``{field…
def field_errors(errors: Any, field_name: str) -> list[str]

Extract validation errors for a single form field.

Safely navigates a{field: [messages]}dict, returning an empty list when errors is None, missing, or the field has no errors.

Parameters
Name Type Description
errors Any
field_name str
Returns
list[str]
qs 2 str ▼
Append query-string parameters to a URL path. Omits parameters whose values ar…
def qs(base: str, **params: Any) -> str

Append query-string parameters to a URL path.

Omits parameters whose values are falsy (None, "", 0, False) so callers can pass optional filters without manual guards.

Parameters
Name Type Description
base str
**params Any
Returns
str
timeago 1 str ▼
Convert a unix timestamp to a human-readable relative time.
def timeago(unix_ts: int | float) -> str
Parameters
Name Type Description
unix_ts int | float
Returns
str
pluralize 3 str ▼
Pluralize a word based on count.
def pluralize(count: int, singular: str, plural: str | None = None) -> str
Parameters
Name Type Description
count int
singular str
plural str | None Default:None
Returns
str
format_time 1 str ▼
Format a unix timestamp as ``HH:MM:SS`` (UTC).
def format_time(unix_ts: float) -> str
Parameters
Name Type Description
unix_ts float
Returns
str