Skip to content

sink

etrack.ports.sink

ports/sink: a client of the event stream — it declares the view it reads and the phases it wants, and takes views.

A sink never sees the whole record: the bus narrows each event onto the sink's view before handing it over, and skips the phases the sink did not ask for before queueing — a sink that ignores token deltas never pays for them.

A remote sink signs its requests through a SignerPort and tells its refusals apart (Refusal): worth another attempt, or final. A sink that keeps what it took may also be watched: WatchPort replays a thread's frames past a cursor, then follows them live, and lists the threads it keeps — what a viewer reads, whatever sink keeps the frames.

LiveFrame

Bases: Struct

A frame as a watcher receives it: its place in the thread, and the event.

LiveSummary

Bases: Struct

A kept thread as a picker lists it: its next offset, its runs in the order they began, its last frame's time.

Refusal

Bases: Struct

Why a remote system did not take what it was sent: the status (0 when the network failed), the reason in its own words, and whether trying again could change it (final: never).

SignerPort

Bases: Protocol

What signs a request to a remote sink: the headers for the next one — a token refreshed when due, an identity of the host's own. The configured Auth meets it; a host hands its own to a driver.

SinkPort

Bases: Provider, Protocol

A consumer of views: what it reads, which phases reach it, and the one call that delivers.

WatchPort

Bases: Protocol

A thread followed live: its frames past after, then every new one; and the threads there are to follow.