Module io 

Object store access for WAL objects: a deterministic key layout and conditional creates that make a retry of the same object a no-op.

Structs

ListedObject 🔒

An object discovered by a LIST.

ObjectStoreIo 🔒

Reads and writes the WAL objects under one prefix.

Enums

PutResult 🔒

Outcome of a conditional create.

Constants

LISTING_AHEAD_OBJECTS 🔒

Objects a listing may hold ahead of the reads that take them, four LIST pages of S3, so the listing stays pages ahead of the reads while what it holds is bounded.

OBJECT_SEQ_WIDTH 🔒

Width of the zero-padded object sequence in an object key, wide enough for u64::MAX so that lexicographic and numeric order agree.

OBJECT_SUFFIX 🔒

PROBE_CONTENT 🔒

Functions

normalize_prefix 🔒

reports_existing_object 🔒

Returns true when a conditional create failed because the object exists. Only the precondition failure says so: a store may report AlreadyExists for an unrelated path, such as a parent that is a file.

settle_listing 🔒

Yields the objects listing sends over rx. Once the listing finished it is settled before any further object is yielded, so its failure goes before the objects it listed that the caller has not taken yet.