Struct refinery::Runner

pub struct Runner { /* fields omitted */ }

Struct that represents the entrypoint to run the migrations, an instance of this struct is returned by the embed_migrations and the mod_migrations runner function, Runner should not need to be instantiated manually

Methods

impl Runner

pub fn new(migrations: &[Migration]) -> Runner

pub fn set_grouped(self, grouped: bool) -> Runner

Set true if all migrations should be grouped and run in a single transaction. by default this is set to false, each migration runs on their own transaction

Note

set_grouped won't probbaly work on MySQL Databases as MySQL lacks support for transactions around schema alteration operations, meaning that if a migration fails to apply you will have to manually unpick the changes in order to try again (it’s impossible to roll back to an earlier point).

pub fn set_abort_divergent(self, abort_divergent: bool) -> Runner

Set true if migration process should abort if divergent migrations are found i.e. applied migrations with the same version but different name or checksum from the ones on the filesystem. by default this is set to true

pub fn set_abort_missing(self, abort_divergent: bool) -> Runner

Set true if migration process should abort if missing migrations are found i.e. applied migrations that are not found on the filesystem, or migrations found on filesystem with a version inferior to the last one applied but not applied. by default this is set to true