Struct DatabaseManager 

pub struct DatabaseManager { /* private fields */ }

Manages database connections for the soar package manager.

This struct manages separate connections for:

• The core database (installed packages)
• Multiple metadata databases (one per repository)

Example

use soar_db::connection::DatabaseManager;

let manager = DatabaseManager::new("/path/to/db")?;

// Access installed packages
let installed = manager.core().list_installed()?;

// Access repository metadata
if let Some(metadata_conn) = manager.metadata("pkgforge") {
    let packages = metadata_conn.search("firefox")?;
}

Implementations

impl DatabaseManager

pub fn new<P: AsRef<Path>>(base_dir: P) -> Result<Self, ConnectionError>

Creates a new database manager with the given base directory.

Arguments

• base_dir - Base directory for database files

The following databases will be created/opened:

• {base_dir}/core.db - Installed packages

Metadata databases are added separately via add_metadata_db.

pub fn add_metadata_db<P: AsRef<Path>>( &mut self, repo_name: &str, path: P, ) -> Result<(), ConnectionError>

Adds or opens a metadata database for a repository.

This method opens the metadata database and migrates any JSON text columns to JSONB binary format. It does NOT run schema migrations since metadata databases are generated externally (e.g., by rusqlite).

Arguments

• repo_name - Name of the repository
• path - Path to the metadata database file

pub fn core(&mut self) -> &mut DbConnection

Gets a mutable reference to the core database connection.

pub fn metadata(&mut self, repo_name: &str) -> Option<&mut DbConnection>

Gets a mutable reference to a metadata database connection.

Returns None if no metadata database exists for the given repository.

pub fn all_metadata( &mut self, ) -> impl Iterator<Item = (&String, &mut DbConnection)>

Gets an iterator over all metadata database connections.

pub fn metadata_names(&self) -> impl Iterator<Item = &String>

Returns the names of all loaded metadata databases.

pub fn remove_metadata_db(&mut self, repo_name: &str) -> Option<DbConnection>

Removes a metadata database connection.