Module data_stream

Expand description

Data stream headers (subgroup, datagram, fetch, object). Draft-14 data streams (§10): subgroup streams, fetch streams, datagrams.

This module follows the draft-14 spec exactly. Key shapes:

Subgroup stream (§10.4.2): starts with a Type byte 0x10..=0x1D whose bit-flags determine whether a Subgroup ID field is present, whether the subgroup ID is zero or the first Object ID, whether extension headers are present, and whether the stream ends at a group boundary. Object IDs are delta-encoded relative to the previous Object ID in the same stream.
Fetch stream (§10.4.4): Type 0x05, Request ID, then a sequence of self-describing objects until FIN.
Datagram (§10.3.1): Type byte 0x00..=0x07 or 0x20..=0x21 with bit-flags for End of Group, Extensions Present, Object ID Present, and Status vs Payload.

Structs§

DatagramObject: Datagram carrying a single object (§10.3.1, Figure 31).
DatagramType: Datagram type byte (§10.3.1, Table 6).
FetchHeader: Fetch stream header (§10.4.4, Figure 34).
FetchObject: One object carried on a fetch stream (§10.4.4, Figure 35).
SubgroupHeader: Subgroup stream header (§10.4.2, Figure 32).
SubgroupObject: One object within a subgroup stream, with the Object ID already resolved from its delta encoding.
SubgroupObjectReader: Stateful reader for the object fields on a subgroup stream.
SubgroupStreamType: Subgroup stream type byte (§10.4.2, Table 7).