Skip to main content

Module test_utils

Module test_utils 

Source
Expand description

Deterministic examples for consumer tests, built from the production owners’ types.

Structs§

TestOracle
An oracle of applied metadata that tests may populate from streamed records.

Constants§

STORE_ID
The store shared by the deterministic storage and format fixtures.

Functions§

announcement
An earlier snapshot announcement preserved by the fixture snapshot.
authored_records
The fixture’s kept source evidence, each change applied by its author: the first write’s insert of the row, its value kept as a digest, then the fixture write’s store part, whose reference x is kept in full, and its execution-only row.
bounded_slot
Seal and sign a bounded slot with public test keys and deterministic nonces.
check_past
Validate the fixture write against its explicitly supplied past.
chunked_snapshot_frames
A snapshot with a merge row spanning chunk boundaries.
chunked_write
A two-audience write with a row frame spanning three chunks.
column
A value with no foreign-key metadata.
concurrent_loss
A concurrent cell loss of the fixture row.
creation
The fixture row’s selected creation, by device one’s first write.
creation_change
The first admin change, carried by slot one.
encoded_examples
Pinned plaintext frames, then a write prefix/header/part chunks and a snapshot prefix/plaintext chunks. Crypto supplies sealed bytes separately.
excluded_loss
The row values of a write excluded by a schema change.
fixture_bytes
Decode a pinned hexadecimal fixture for consumer tests.
frame_examples
Bounded canonical frames used to exercise every byte and truncation.
identity
Ana’s id with her original pair, as identity custody holds it.
invite
Invite contents with a fixed test secret.
join_request
Ana’s request answering the re-binding invite with her replacement pair, which signs it (D8, D13).
keychain_restore
The restore code as coven saves it for the person, named by a rename at slot 41.
keys_from_seed
A private pair whose signing and sealing seeds are both seed: public test data.
loss_entry
A reset’s slot used by loss examples.
member
The public halves of Ana’s original pair.
member_id
The fixture member Ana’s stable id, independent of every key she holds.
member_keys
Ana’s original private pair, with fixed public test seeds 0x33.
member_removal
A member-removal admin change.
merge_row
The fixture’s merged row, with an actual concurrent loss validated by merge.
merge_row_of
A merge row of row whose cell x holds value.
objects
Every independently decoded ordinary object kind.
oracle
Three applied writes, including two concurrent setters of the fixture row.
other_member
Ben’s initial public pair, with fixed public test seeds 0x35.
other_member_id
Another member, Ben, whom the fixtures add and remove.
past
The fixture author has read these original writes.
position
An original write by device one.
replacement
The public halves of Ana’s replacement pair, bound to the same id.
replacement_keys
Ana’s replacement private pair, with fixed public test seeds 0x34 (§10).
restore
Restore contents with test seeds and that S3 location, without a key.
retained_losses
Both kinds of loss after their row’s merge history has been discarded.
row
A row with a text key in the store.
slot_header
The deterministic header of a device-one claim.
slot_path
A canonical path for one positive slot number.
snapshot_frames
A complete example snapshot emitted by the production streaming encoder.
snapshot_header
The header for the fixture’s eleven snapshot sections.
snapshot_prefix
The sealed prefix carrying a snapshot’s coverage, with a fixed test key.
snapshot_records
Records in their canonical section and identity order.
store_changes
Each admin operation in its canonical tag order.
store_key
The public fixture’s store key, whose bytes are committed by creation.
timestamp
The fixture write’s timestamp.
transient_execution
A row the fixture write inserts and deletes again: no net change, two operations, which still reach the write’s authorship leaves (D5).
write
A write updating one cell, with named foreign-key metadata on its new value.
write_evidence
Evidence for the fixture write’s store part, opening its updated cell.
write_plaintext
A plaintext queue value produced by the format’s queue encoder.