server.sender

Whether an HTTP status code permits a response body.

Structural view of the response objects the early-hint helpers read.

BothResponseand StreamingResponse expose headersas a tuple of(name, value)pairs; the early-hint collector only needs that.

True when aLink header value carries a 103-worthy rel=token.

Parses only therelparameter(s); a single Link header may declare more than one relation (rel="preconnect dns-prefetch") so each token is checked. Matching is case-insensitive per RFC 8288.

CollectLinkheaders eligible for a 103 Early Hints frame.

Reads theLinkheaders already present on response (the header convention — no new public surface) and returns the latin-1-encoded (b"link", value) pairs whose rel=is asset-preload-class. Returns an empty list when nothing is eligible, in which case no 103 frame is emitted.

Emit a preliminary103 Early Hintsstart frame, if warranted.

pounce 0.8.0 surfaces 103 purely as a status convention on http.response.start: it never auto-derives the hint from the final response'sLinkheaders (the H1/H2/H3 bridges only special-case status == 103). So Chirp must explicitly send the interim frame before the final start. The sameLinkheaders remain on the final response — RFC 8297 treats the 103 hint as advisory and the canonicalLinkheader still belongs on the final message.

The interim frame carries no body and does not flip pounce's response_started, so the final response flows normally over H1/H2/H3. On the buffering sync path pounce raisesNeedsAsyncErrorfor any 1xx start and re-runs the request on the async worker, so this is safe there too.

Translate a chirp Response into ASGI send() calls.

Send a streaming response via chunked transfer encoding.

Sends headers immediately, then each chunk as an ASGI body message withmore_body=True. Closes with an empty body. On mid-stream error, emits an HTML comment and closes.

Format a POSIX timestamp as an RFC 7231 IMF-fixdate string.

Return True if anIf-Rangevalidator still matches the representation.

Per RFC 9110 §13.1.5 the value is either an entity-tag or an HTTP-date. An entity-tag is compared with the strong comparison function (a weak validator on either side never matches), and an HTTP-date matches only when it is byte-for-byte the currentLast-Modifiedvalue. When the validator no longer matches the caller must ignoreRangeand serve the full 200 representation.

Parse a singlebytes=Range spec.

Send aFileResponsefrom disk with conditional-GET / Range support.

Streams the body inchunk_sizereads off the event loop via run_sync() (matching the data/cache to_thread precedent). Files smaller thanstream_thresholdare read in a single shot to keep small-file latency unchanged; larger files stream chunk-by-chunk so worker RSS stays bounded.

HonoursIf-None-Match(weak compare, takes precedence) and If-Modified-Since -> 304, and a single byte Range-> 206 (416 when unsatisfiable) whenresponse.conditionalis True.

On mid-stream IO error the stream is closed without an HTML error body — you cannot inject markup into a half-sent binary payload.

Cache-Control header value, defaulting when not set on the response.