Struct QuarantineState 

pub struct QuarantineState {
    pub storage_version: u32,
    pub entries: BTreeMap<String, QuarantineRecord>,
}

In-memory view of the quarantine state file. Use QuarantineState::load to read, QuarantineState::record_attempt / QuarantineState::clear to mutate, and QuarantineState::save to atomically persist.

Fields

storage_version: u32

Storage version of the file format itself (not the schema_version inside the keys). Bumped when the on-disk shape changes.

entries: BTreeMap<String, QuarantineRecord>

Keyed by QuarantineKey::storage_key() for stable JSON ordering.

Implementations

impl QuarantineState

pub const FILENAME: &'static str = "quarantine_state.json"

Filename used inside data_dir. Stable on disk so external tooling can locate the state.

pub fn path(data_dir: &Path) -> PathBuf

pub fn load(data_dir: &Path) -> Self

Load the quarantine state from <data_dir>/quarantine_state.json. Returns an empty state when the file is missing or malformed — quarantine is best-effort metadata and an unreadable state file must not block indexing.

pub fn save(&self, data_dir: &Path) -> Result<()>

Atomically write the quarantine state to disk via temp file + rename, so partial writes can never produce a corrupt quarantine_state.json.

pub fn record_attempt( &mut self, key: &QuarantineKey, reason: impl Into<String>, now: DateTime<Utc>, )

Record an attempt that failed irreducibly on key. If the key already exists, the existing record is updated in place (last_attempt_at, attempt_count, last_reason) rather than appended — this is the dedup contract from #243.

pub fn clear(&mut self, key: &QuarantineKey) -> bool

Remove a quarantine entry. Called by cass quarantine clear after the operator has confirmed the underlying issue is resolved (e.g. a memory bump on the streaming consumer, a schema fix, or accepting the loss).

pub fn len(&self) -> usize

Number of currently-quarantined (conversation_id, schema_version) keys. This is what cass health and the indexer JSON envelope surface as quarantined_conversations.

pub fn is_empty(&self) -> bool

pub fn iter( &self, ) -> impl Iterator<Item = (QuarantineKey, &QuarantineRecord)> + '_

Iterate over (key, record) pairs in deterministic order.

Trait Implementations

impl Clone for QuarantineState

fn clone(&self) -> QuarantineState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for QuarantineState

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for QuarantineState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for QuarantineState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for QuarantineState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.