Enum NamedRootRetention 

pub enum NamedRootRetention {
    All,
    Exact {
        names: Vec<Vec<u8>>,
    },
    Prefix {
        prefix: Vec<u8>,
    },
    NewestByName {
        prefix: Vec<u8>,
        count: usize,
    },
    UpdatedSince {
        prefix: Vec<u8>,
        min_updated_at_millis: u64,
    },
}

Policy for selecting named roots to retain during garbage collection.

NewestByName keeps the lexicographically greatest names matching prefix. This works well for names that include sortable sequence numbers or timestamps, for example checkpoint/000042 or checkpoint/2026-07-01T12:00:00Z.

Variants

All

Retain every named root in the manifest store.

Exact

Retain an explicit list of root names.

Fields

names: Vec<Vec<u8>>

Exact names to load.

Prefix

Retain every named root whose name starts with prefix.

Fields

prefix: Vec<u8>

Name prefix to retain.

NewestByName

Retain the lexicographically newest count roots with a prefix.

Fields

prefix: Vec<u8>

Name prefix to retain.

count: usize

Maximum number of roots to retain.

UpdatedSince

Retain roots with updated_at_millis >= min_updated_at_millis.

Fields

prefix: Vec<u8>

Optional name prefix to retain.

min_updated_at_millis: u64

Minimum update timestamp in Unix milliseconds.

Implementations

impl NamedRootRetention

pub fn all() -> Self

Retain every named root in the manifest store.

pub fn exact<I, N>(names: I) -> Self

where I: IntoIterator<Item = N>, N: AsRef<[u8]>,

Retain an explicit list of named roots.

pub fn prefix(prefix: impl AsRef<[u8]>) -> Self

Retain every named root whose name starts with prefix.

pub fn newest_by_name(prefix: impl AsRef<[u8]>, count: usize) -> Self

Retain the lexicographically newest count roots with prefix.

pub fn updated_since( prefix: impl AsRef<[u8]>, min_updated_at_millis: u64, ) -> Self

Retain roots updated at or after min_updated_at_millis.

pub fn updated_within( prefix: impl AsRef<[u8]>, now_millis: u64, max_age: Duration, ) -> Self

Retain roots updated within max_age before now_millis.

now_millis is explicit so tests, replay, and distributed systems can choose their own clock source. The cutoff saturates at zero when max_age is larger than now_millis.

pub fn updated_within_millis( prefix: impl AsRef<[u8]>, now_millis: u64, window_millis: u64, ) -> Self

Retain roots updated within window_millis before now_millis.

pub fn updated_within_days( prefix: impl AsRef<[u8]>, now_millis: u64, days: u64, ) -> Self

Retain roots updated within days calendar-day windows before now_millis.

This is a convenience wrapper for retention rules such as “keep roots updated in the last 7 days”. A day is treated as exactly 86,400,000 milliseconds.

Trait Implementations

impl Clone for NamedRootRetention

fn clone(&self) -> NamedRootRetention

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NamedRootRetention

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

Formats the value using the given formatter.

impl PartialEq for NamedRootRetention

fn eq(&self, other: &NamedRootRetention) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NamedRootRetention