Struct ModuleDb 

pub struct ModuleDb { /* private fields */ }

Standard module database.

Single entry point for all module storage. Opens DB at {data_dir}/db/, runs migrations, provides named trees.

Implementations

impl ModuleDb

pub fn open<P: AsRef<Path>>(data_dir: P) -> Result<Self>

Open the module database at {data_dir}/db/.

Uses the same backend as the node when MODULE_CONFIG_DATABASE_BACKEND is set.

pub fn open_with_migrations<P: AsRef<Path>>( data_dir: P, migrations: &[(u32, MigrationUp)], ) -> Result<Self>

Open and run migrations. Convention for modules that use migrations.

pub fn open_or_temp<P: AsRef<Path>>( data_dir: P, module_name: &str, ) -> Result<Self>

Open at data_dir, or fallback to temp dir when primary open fails.

Both attempts use open_module_db (Sled/TidesDB). Avoids a hard-coded Redb fallback, which fails when blvm-node is built without redb.

pub fn open_or_temp_with_migrations<P: AsRef<Path>>( data_dir: P, module_name: &str, migrations: &[(u32, MigrationUp)], ) -> Result<Self>

Like open_or_temp but runs migrations when the primary data_dir succeeds.

pub fn run_migrations(&self, migrations: &[(u32, MigrationUp)]) -> Result<()>

Run pending migrations.

pub fn tree(&self, name: &str) -> Result<Arc<dyn Tree>>

Open a named tree. Use descriptive constants defined in your module.

pub fn as_db(&self) -> Arc<dyn Database>

Access the underlying database (for compatibility with code expecting Arc<dyn Database>).

Trait Implementations

impl Clone for ModuleDb

fn clone(&self) -> ModuleDb

Returns a duplicate of the value.

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

Performs copy-assignment from source.