Module

contracts.rules_vary

Contract rules for Vary header correctness.

Warns when templates manually branch onis_fragment / HX-Request outside of Chirp'sPage return type, which auto-sets Vary: HX-Request. Manual branching withoutVarycauses HTTP caches to serve the wrong response variant.

1Function

Functions

check_vary_coverage 1 list[ContractIssue] ▼
Warn when templates branch on htmx request state. Chirp's ``Page`` return type…
def check_vary_coverage(template_sources: dict[str, str]) -> list[ContractIssue]

Warn when templates branch on htmx request state.

Chirp'sPage return type sets Vary: HX-Requestautomatically. If a template manually checksis_fragment (via {% if %}blocks), it likely needs thePage type or explicit Varyhandling.

Parameters
Name Type Description
template_sources dict[str, str]
Returns
list[ContractIssue]