migrant_lib

Embeddable migration management

Also see migrant CLI

migrant_lib allows defining and embedding management of migrations in your compiled application.

Available Features:

| Feature | Backend | |---------------|------------------------------| | d-postgres | Enable postgres connectivity | | d-sqlite | Enable sqlite connectivity | | d-mysql | Enable mysql connectivity | | d-all | Enable all backends |

Note: No features are enabled by default

• Migrations can be defined as files or functions.
• File migrations can be either read from files at runtime or embedded in your executable at compile time.
• Migration tags must all be unique and may only contain the characters [a-z0-9-].
• Function migrations must have the signature fn(DbConn) -> Result<(), Box<std::error::Error>>. See the embedded_programmable example for a working sample of function migrations.
• When working with embedded and function migrations, the respective database feature must be enabled (d-postgres / d-sqlite / d-mysql).
• When database features are enabled, the entirety of the database-specific connection library will be re-exported in the types module.

```rust fn up(_: DbConn) -> Result<(), Box> { print!(" Up!"); Ok(()) }

fn down(_: DbConn) -> Result<(), Box> { print!(" Down!"); Ok(()) }

config.usemigrations(vec![ FileMigration::withtag("initial")? .up("migrations/embedded/initial/up.sql")? .down("migrations/embedded/initial/down.sql")? .boxed(), EmbeddedMigration::withtag("second")? .up(includestr!("../migrations/embedded/second/up.sql")) .down(includestr!("../migrations/embedded/second/down.sql")) .boxed(), FnMigration::withtag("custom")? .up(up) .down(down) .boxed(), ])?; ```

Migrations management identical to the migrant cli tool can also be embedded. This method only supports file-based migrations and those migration files must be generated by migrant_lib::new (or the migrant cli). This is required because migration order is implied by file names which must follow a specific format and contain a valid timestamp.

See the migrantclicompatible example for a working sample.

License: MIT