Struct BlockManagerConfigBuilder 

pub struct BlockManagerConfigBuilder<T: BlockMetadata> { /* private fields */ }

Builder for BlockManager configuration.

Construct via BlockManager::builder() and finish with build().

Implementations

impl<T: BlockMetadata> BlockManagerConfigBuilder<T>

pub fn new() -> Self

Create a new builder.

pub fn block_count(self, count: usize) -> Self

Set the number of blocks in the pool.

pub fn block_size(self, size: usize) -> Self

Set the block size (number of tokens per block).

Requirements

• Must be >= 1 and <= 1024
• Must be a power of 2

Panics

Panics if the block size doesn’t meet requirements.

pub fn duplication_policy(self, policy: BlockDuplicationPolicy) -> Self

Set the duplication policy.

pub fn registry(self, registry: BlockRegistry) -> Self

Set the block registry.

pub fn with_lru_backend(self) -> Self

Use simple LRU backend (capacity automatically set to block_count).

pub fn with_multi_lru_backend(self) -> Self

Use multi-level LRU backend with 4 fixed priority levels.

Default thresholds: [3, 8, 15] for transitions between: Cold (0-2 hits) -> Warm (3-7) -> Hot (8-14) -> Very Hot (15+).

pub fn with_multi_lru_backend_custom_thresholds( self, cold_to_warm: u8, warm_to_hot: u8, hot_to_very_hot: u8, ) -> Self

Use multi-level LRU with custom frequency thresholds.

Requirements

• Thresholds must be in ascending order: cold_to_warm < warm_to_hot < hot_to_very_hot
• hot_to_very_hot must be <= 15 (4-bit counter maximum)
• cold_to_warm must be >= 1 (to distinguish from never-accessed blocks)

Arguments

• cold_to_warm - Minimum frequency to move from Cold to Warm level
• warm_to_hot - Minimum frequency to move from Warm to Hot level
• hot_to_very_hot - Minimum frequency to move from Hot to Very Hot level

Panics

Panics if thresholds don’t meet the requirements above.

pub fn with_hashmap_backend(self, reuse_policy: Box<dyn ReusePolicy>) -> Self

Use HashMap backend with custom reuse policy.

pub fn with_lineage_backend(self) -> Self

Use lineage backend.

pub fn aggregator(self, aggregator: MetricsAggregator) -> Self

Set a metrics aggregator for prometheus export.

The aggregator will automatically receive this manager’s metrics source.

pub fn build(self) -> Result<BlockManager<T>, BlockManagerBuilderError>

Build the BlockManager.

Validates configuration and constructs all pools, the upgrade closure, and the metrics source. Returns an error if validation fails or backend construction fails.

Trait Implementations

impl<T: BlockMetadata> Default for BlockManagerConfigBuilder<T>

fn default() -> Self

Returns the “default value” for a type.