Struct Runner

pub struct Runner<C>
where
    C: MigrationContext,
{ /* private fields */ }

Run operations on a set of migrations for the chosen context.

Implementations

impl<C> Runner<C>

where C: MigrationContext,

pub fn new(context: C) -> Runner<C>

Create a new Runner with default arguments from a context.

pub async fn init_history(&mut self) -> Result<(), Error>

CREATE IF NOT EXISTS the history table.

pub async fn drop_history(&mut self) -> Result<(), Error>

DROP the history table.

pub async fn run_apply( &mut self, target_version: Option<i64>, dryrun: bool, ) -> Result<Report, Error>

Apply unapplied migrations up to and including the specified version.

pub async fn apply_all(&mut self) -> Result<Report, Error>

👎Deprecated since 3.1.0: use run_apply_all

Apply all unapplied migrations.

pub async fn run_apply_all(&mut self, dryrun: bool) -> Result<Report, Error>

Apply all unapplied migrations.

pub async fn list_applied(&mut self) -> Result<Report, Error>

List the migrations that have already been applied.

pub async fn soft_apply( &mut self, start_version: Option<i64>, target_version: Option<i64>, ) -> Result<Report, Error>

👎Deprecated since 3.1.0: no valid use case for start_version

pub async fn run_soft_apply( &mut self, target_version: Option<i64>, dryrun: bool, ) -> Result<Report, Error>

Run a “soft apply” of the migrations up to and including the specified version.

This means that the migration will be saved in the history table, but will not have its query applied. This is useful in the case where you want to change migration tables, apply a patch to the current one, migrate from a different migration tool, etc.