Struct MigrationRegistry 

pub struct MigrationRegistry { /* private fields */ }

Names → forward (and optional backwards) functions.

Implementations

impl MigrationRegistry

pub fn new() -> Self

Empty registry.

pub fn register( &mut self, name: impl Into<String>, f: impl Fn(Db) -> RustFuture + Send + Sync + 'static, )

Register name. The same map is used for forwards and backwards; a reversible RunRust stores both names as separate entries.

Args: name: Operation identifier in the migration file. f: Callback whose future owns completion of its work.

Returns: None after registering with ordinary, conservative retry policy.

Unconfirmed non-transactional execution blocks automatic retry. Use register_replay_safe only with an established idempotence contract.

pub fn register_replay_safe( &mut self, name: impl Into<String>, f: impl Fn(Db) -> RustFuture + Send + Sync + 'static, )

Register a callback whose committed effects can safely be repeated.

Args: name: Operation name used by the migration file. f: Callback safe to retry after interruption at any await point.

Returns: None after registering the callback and its explicit retry policy.

Use only after establishing idempotence for database and external effects. Registration permits retry; it does not verify idempotence. Ordinary register clears this declaration when replacing a name.

pub async fn run(&self, name: &str, db: &Db) -> Result<(), MigrationError>

Run the function named name.

On SQLite the function runs on the schema-change connection with PRAGMA foreign_keys off (see the migrations guide), so data code must stay FK-clean by hand; orphans fail the migration at commit.

Errors

MigrationError::UnregisteredRust or the function’s own error.

Trait Implementations

impl Clone for MigrationRegistry

fn clone(&self) -> MigrationRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MigrationRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MigrationRegistry

fn default() -> MigrationRegistry

Returns the “default value” for a type.