Skip to content

blackbull.server.http2_actor

blackbull.server.http2_actor

HTTP/2 Actor classes for the BlackBull actor model.

HTTP2Actor drives the HTTP/2 connection state machine for one TCP connection. StreamActor owns the lifetime of a single HTTP/2 stream.

HTTP2Actor

Bases: Actor, HTTP2Connection

Drives the HTTP/2 connection state machine for one connection.

Supervisor strategy: propagate — framing errors send GOAWAY and raise, surfacing to the caller.

If aggregator is None the actor dispatches events directly through app._dispatcher instead.

on_priority_update(frame)

RFC 9218 §7.1: record a stream's priority hint; nothing schedules on it.

receive() async

Read one HTTP/2 frame from the connection.

run() async

HTTP/2 connection state machine — process frames until connection closes.

send_frame(frame) async

Send a control frame and meter every emitted RST_STREAM at this boundary.

StreamActor

Bases: Actor

Run one HTTP/2 request through RequestActor with a native Connection.

Isolate unhandled failure with RST_STREAM; do not share per-stream state.