Struct StorageCompactor 

pub struct StorageCompactor { /* private fields */ }

Background compaction manager.

Maintains a set of storage regions described by (offset, size, is_used) tuples and can analyse/compact them on demand.

Implementations

impl StorageCompactor

pub fn new(config: CompactorConfig) -> Self

Create a new compactor with the given configuration.

pub fn add_region(&mut self, offset: u64, size: u64, is_used: bool)

Register a storage region.

pub fn remove_region(&mut self, offset: u64) -> bool

Remove the region at the given offset. Returns true if a region was found and removed.

pub fn analyze(&mut self) -> FragmentationReport

Analyse the current region set and return a fragmentation report.

Sets the compactor state to CompactionState::Analyzing during the call and back to CompactionState::Idle afterwards (unless the compactor was already in a terminal state).

pub fn should_compact(&self) -> bool

Returns true if compaction should be triggered based on the current fragmentation ratio and the configured interval.

pub fn compact(&mut self) -> Result<CompactionResult, String>

Run compaction: sort regions by offset, merge adjacent free regions.

Returns an error if the compactor is already in the Compacting state.

pub fn tick(&mut self)

Advance the logical clock by one tick.

pub fn reclaimed_bytes(&self) -> u64

Total bytes reclaimed across all compaction runs.

pub fn stats(&self) -> CompactorStats

Return a snapshot of the compactor’s cumulative statistics.