Live-block declarations for hybrid static/dynamic freeze output.
A live block is a named template block on a frozen page that is swapped out
at freeze time for an htmx placeholder. At request time the placeholder hits
the block-fetch dispatcher (/_frag{path}?_b=\{block}) and the declared
handler renders the block dynamically.
Declarations are registered vialive_block() and stored in
MutableAppState.live_blocks keyed by (route, block). The freeze
pipeline consults this map during post-processing; the dispatcher uses the
same map to resolve which handler to invoke (falling back to the route's
native handler when the live-block handler is the same as the route's).
live_blocks
| Name | Type | Default | Description |
|---|---|---|---|
type
|
|
— | |
qualified_name
|
|
— | |
element_type
|
|
— | |
description
|
|
— | |
source_file
|
|
— | |
line_number
|
|
— | |
is_autodoc
|
|
— | |
autodoc_element
|
|
— | |
_autodoc_template
|
|
— | |
_autodoc_url_path
|
|
— | |
_autodoc_page_type
|
|
— | |
title
|
|
— | |
doc_content_hash
|
|
— |
Symbols on this page
LiveBlockSpec
class
Declaration of one live block on one route.
View source · /home/runner/work/chirp/chirp/site/../src/chirp/live_blocks.py:1