Struct BlockCompressionAdvisor 

pub struct BlockCompressionAdvisor {
    pub profiles: HashMap<String, BlockProfile>,
    pub config: AdvisorConfig,
}

Analyses block access patterns and sizes to recommend optimal compression codecs and tracks achieved compression ratios.

Fields

profiles: HashMap<String, BlockProfile>

Per-block profiles keyed by CID.

config: AdvisorConfig

Configuration thresholds used by the recommendation logic.

Implementations

impl BlockCompressionAdvisor

pub fn new(config: AdvisorConfig) -> Self

Creates a new advisor with the supplied configuration.

pub fn register_block( &mut self, cid: String, raw_size_bytes: u64, access_count: u64, )

Registers a block (or updates its raw_size_bytes and access_count if it already exists).

pub fn record_compression( &mut self, cid: &str, compressed_size_bytes: u64, codec: CompressionCodec, )

Records the outcome of a compression operation for an existing block.

Has no effect when the CID is unknown.

pub fn recommend(&self, cid: &str) -> Option<AdvisorRecommendation>

Returns a codec recommendation for the block identified by cid.

Returns None when:

• the block is not registered, or
• the block’s raw size is below AdvisorConfig::min_size_for_compression.

pub fn recommend_all(&self) -> Vec<AdvisorRecommendation>

Returns recommendations for every registered block that qualifies for compression, sorted by estimated_savings_bytes in descending order.

pub fn total_space_savings(&self) -> u64

Returns the total bytes saved across all profiles that have been compressed.

pub fn stats_for(&self, cid: &str) -> Option<&BlockProfile>

Returns an immutable reference to the profile for cid, if it exists.