Module

`formatter`

Opinionated template formatter for Kida.

Auto-formats Kida templates with consistent whitespace, indentation, and tag spacing. No other Python template engine has a formatter.

Rules:

Usage::

from kida.formatter import format_template
formatted = format_template(source)

CLI::

kida fmt templates/

Functions

format_template 4 str ▼

Format a Kida template source string.

def format_template(source: str, *, indent: int = 2, max_blank_lines: int = 1, normalize_tag_spacing: bool = True) -> str

Name	Type	Description
`source`	`str`	Template source text.
`indent`	`int`	Number of spaces per indentation level. Default:`2`
`max_blank_lines`	`int`	Maximum consecutive blank lines to allow. Default:`1`
`normalize_tag_spacing`	`bool`	If True, normalize spacing inside tags. Default:`True`

str

_normalize_tag_spacing 1 str ▼

Normalize spacing inside template tags.

def _normalize_tag_spacing(source: str) -> str

Name	Type	Description
`source`	`str`

str

_get_block_keyword 1 str | None ▼

Extract the block keyword from a line containing a block tag.

def _get_block_keyword(line: str) -> str | None

Name	Type	Description
`line`	`str`

str | None

_should_dedent_before 1 bool ▼

Check if this line should be dedented (closing/continuation tags).

def _should_dedent_before(stripped: str) -> bool

Name	Type	Description
`stripped`	`str`

bool

_count_indent_change 1 int ▼

Count net indent change for this line. Returns +1 for block openers, -1 for cl…

def _count_indent_change(stripped: str) -> int

Count net indent change for this line.

Returns +1 for block openers, -1 for closers that also re-indent (like else which dedents then indents).

Name	Type	Description
`stripped`	`str`

int