Struct StorageBuilder 

pub struct StorageBuilder { /* private fields */ }

Builder for creating storage instances from configuration.

StorageBuilder provides layered access to the underlying SlateDB DbBuilder, replacing the previous StorageRuntime middleman.

Example

use common::{StorageBuilder, StorageSemantics, create_object_store};
use common::storage::factory::CompactorBuilder;

// Simple usage:
let storage = StorageBuilder::new(&config.storage).await?
    .with_semantics(StorageSemantics::new().with_merge_operator(Arc::new(MyOp)))
    .build()
    .await?;

// Escape hatch for low-level SlateDB configuration:
let storage = StorageBuilder::new(&config.storage).await?
    .map_slatedb(|db| {
        let obj_store = create_object_store(&slate_config.object_store).unwrap();
        db.with_compactor_builder(
            CompactorBuilder::new(slate_config.path.clone(), obj_store)
                .with_runtime(compaction_runtime.handle().clone())
        )
    })
    .build()
    .await?;

Implementations

impl StorageBuilder

pub async fn new(config: &StorageConfig) -> StorageResult<Self>

Creates a new StorageBuilder from a StorageConfig.

For SlateDB configs this creates a DbBuilder with the configured path, object store, settings, and block cache (if configured). For InMemory configs it stores a sentinel so that build() returns an InMemoryStorage.

pub fn with_semantics(self, semantics: StorageSemantics) -> Self

Sets the StorageSemantics (merge operator, etc.) for this builder.

pub fn map_slatedb( self, f: impl FnOnce(DbBuilder<String>) -> DbBuilder<String>, ) -> Self

Maps over the underlying DbBuilder for low-level SlateDB configuration.

This is the escape hatch for any SlateDB knob not exposed by StorageBuilder itself (compactor builder, block cache, GC runtime, etc.). Use db.with_db_cache(...) inside the closure to override the config-driven block cache.

For InMemory storage this is a no-op.

pub async fn build(self) -> StorageResult<Arc<dyn Storage>>

Builds the storage instance.

Applies semantics (merge operator) to the DbBuilder and calls .build().