Struct MigrationManager 

pub struct MigrationManager { /* private fields */ }

Central migration system manager that orchestrates schema evolution.

The MigrationManager maintains the complete registry of available migrations and provides the logic for applying them in the correct order. It ensures that migrations are applied atomically and tracks their completion status.

Implementations

impl MigrationManager

pub fn new() -> Self

Creates a new migration manager with all registered migrations.

Example

use kasl::db::migrations::MigrationManager;

let manager = MigrationManager::new();
// Manager is ready to apply migrations

pub fn run_migrations(&self, conn: &mut Connection) -> Result<()>

Executes all pending migrations in the correct order.

Example

use kasl::db::migrations::MigrationManager;
use rusqlite::Connection;

let manager = MigrationManager::new();
let mut conn = Connection::open(":memory:")?;
manager.run_migrations(&mut conn)?;

pub fn is_migration_applied( &self, conn: &Connection, version: u32, ) -> Result<bool>

Checks if a specific migration version has been applied.

This utility method allows callers to verify whether a particular migration has been successfully applied to the database. Useful for conditional logic based on schema capabilities.

Example

use kasl::db::migrations::MigrationManager;
use rusqlite::Connection;

let manager = MigrationManager::new();
let mut conn = Connection::open(":memory:")?;
manager.run_migrations(&mut conn)?;
if manager.is_migration_applied(&conn, 3)? {
    // Tags system is available
}

pub fn get_migration_history( &self, conn: &Connection, ) -> Result<Vec<(u32, String, String)>>

Retrieves the complete migration history with timestamps.

Example

use kasl::db::migrations::MigrationManager;
use rusqlite::Connection;

let manager = MigrationManager::new();
let mut conn = Connection::open(":memory:")?;
manager.run_migrations(&mut conn)?;
let history = manager.get_migration_history(&conn)?;
for (version, name, applied_at) in history {
    println!("v{}: {} ({})", version, name, applied_at);
}

pub fn rollback_to( &self, conn: &mut Connection, target_version: u32, ) -> Result<()>

Rolls back migrations to a specific target version (debug builds only).

This development utility allows rolling back migrations to a previous schema version by removing migration records from the tracking table.

Example

use kasl::db::migrations::MigrationManager;
use rusqlite::Connection;

#[cfg(debug_assertions)]
{
    let manager = MigrationManager::new();
    let mut conn = Connection::open(":memory:")?;
    manager.run_migrations(&mut conn)?;
    manager.rollback_to(&mut conn, 2)?; // Roll back to version 2
}

Trait Implementations

impl Default for MigrationManager

fn default() -> Self

Returns the “default value” for a type.