Glossary

The terms that show up across Stario docs and code.

One sentence per term, and the page that says more.

App
The application object. It holds the route table, the middleware, and the shutdown signal. See Runtime.
Assets
A directory of static files served under one URL prefix, with a content hash in every URL so browsers can cache forever. See Files and assets.
Attrs
Pre-rendered attribute text for an opening tag, made by helpers such as classes and data. See HTML.
Bootstrap
The async generator serve() runs to start an app. It registers routes before its single yield and cleans up after it. See Runtime.
Context, c
The first argument of a handler. It carries the request, the matched route, the span, and a dict for this request. See Request and context.
Datastar
A small browser library that sends requests from HTML attributes and morphs HTML it receives into the page. stario.datastar is its Python side. See Datastar.
Files
A directory served under one URL prefix without content hashes, for files that change while the app runs. See Files and assets.
Handler
An async def handler(c, w) that reads the request from c and writes the response through w. See Handlers and the writer.
Live page
A page that keeps one response open and receives new HTML through it when state changes. See Live pages.
Match
The result of routing a request: the route pattern and the captured path parameters, on c.match. See Routing.
Middleware
A function that takes a handler and returns a handler, attached to a path prefix with app.use. See Routing.
Relay
In-process publish and subscribe, used to tell open streams that something changed. See Relay.
Route
One HTTP method on one path, as a value. You register it, link to it with href(), and test with it. See Routing.
Server
The asyncio listener that accepts connections and runs an App. serve() constructs it for you. See Runtime.
Signals
The page state Datastar keeps in the browser and sends with each request, as JSON. See Datastar.
Span
One unit of telemetry. Every request is a span; you can add attributes, events, and child spans. See Telemetry.
SSE
The helper that writes server-sent events to a Writer, including HTML patches and signal updates for Datastar. See Datastar.
Tracer
The object that creates spans and exports finished ones, to the terminal, to JSON, to SQLite, or nowhere. See Telemetry.
Writer, w
The second argument of a handler. It sends the status, the headers, and the body, once. See Responses.