Crates.io | assert-migrator-reversible |
lib.rs | assert-migrator-reversible |
version | 6.1.0 |
source | src |
created_at | 2022-10-25 21:41:55.927203 |
updated_at | 2024-05-13 23:36:45.666354 |
description | For testing if Sea Orm Migrators are reversible |
homepage | |
repository | https://github.com/JosephLenton/assert-migrator-reversible |
max_upload_size | |
id | 697262 |
size | 37,978 |
A crate for testing Sea Orm Migrators. To check if when you call up
and then down
on them. They work in both directions.
It runs your migrations up and down one at a time. Taking a look at the differences it does to a database. Checking if the reverse returns a database into it's previous state.
Supports Postgres and SQLite migrations.
The most common use case is simply to test if your Migrator
is reversible.
In a test. Then error if it is not.
To do this add the following test to your migrations project ...
assert-migrator-reversible = "1"
#[cfg(test)]
mod test_migrator {
use crate::path::to::my::Migrator;
use ::assert_migrator_reversible::assert_migrator_reversible;
#[test]
fn it_should_have_reversible_migrations() {
assert_migrator_reversible(Migrator, None);
}
}
This test will use SQLite by default (that's what passing in None
does).
tokio::test
If you are already using Tokio to test your project. Then the following may be better.
assert-migrator-reversible = { version = "1", default-features = false }
#[cfg(test)]
mod test_migrator {
use crate::path::to::my::Migrator;
use ::assert_migrator_reversible::assert_migrator_reversible_async;
#[tokio::test]
async fn it_should_have_reversible_migrations() {
assert_migrator_reversible_async(Migrator, None).await
}
}
(Again, this example will use SQLite as it passes in None
).
Testing against Postgres requires passing in the url to the database. It will not be picked up by default from the environment variables. You must specify it.
#[cfg(test)]
mod test_migrator {
use crate::path::to::my::Migrator;
use ::assert_migrator_reversible::assert_migrator_reversible;
use ::assert_migrator_reversible::DbConnection;
const POSTGRES_DB_URL : &'static str = &"postgres://user:password@localhost:5432/my_database";
#[test]
fn it_should_have_reversible_migrations() {
let db_conn = Some(DbConnection::Url(POSTGRES_DB_URL));
assert_migrator_reversible(Migrator, db_conn);
}
}
You can also build your own Sea Orm DatabaseConnection
object and pass this in for use ...
#[cfg(test)]
mod test_migrator {
use crate::path::to::my::Migrator;
use ::assert_migrator_reversible::assert_migrator_reversible;
use ::assert_migrator_reversible::DbConnection;
use ::sea_orm_migration::sea_orm::Database;
use ::sea_orm_migration::sea_orm::DatabaseConnection;
const POSTGRES_DB_URL : &'static str = &"postgres://user:password@localhost:5432/my_database";
#[tokio::test]
async fn it_should_have_reversible_migrations() {
let db_connection = Database::connect(db_url)
.await
.expect("expect DatabaseConnection to be created");
let db_conn = Some(DbConnection::DatabaseConnection(db_connection));
assert_migrator_reversible_async(Migrator, db_conn).await
}
}
The library provides two non-async functions. These handle the async bits for you by bundling Tokio.
assert_migrator_reversible
- The main way to test if your Migrator is reversible. Pass in a Migrator. It'll run it up and down. If it isn't reversible, it will panic.find_index_of_non_reversible_migration
- This is very similar to assert_migrator_reversible
. It will find a migration that isn't reversible. When found, it will return the index. It will not panic.Async versions of those functions are available. This is useful if you wish to not have this import Tokio (as it's quite big). Instead handle this yourself.
tokio
Default - This adds Tokio support. Which enables the functions assert_migrator_reversible
and find_index_of_non_reversible_migration
. This makes testing easier and simpler. You might want to disable this if you are already using Tokio in your tests, and wish to make this dependency smaller.runtime-actix-native-tls
- Sets Sea-Orm Migrations to use this runtime.runtime-actix-rustls
- Sets Sea-Orm Migrations to use this runtime.runtime-async-std-native-tls
- Sets Sea-Orm Migrations to use this runtime.runtime-async-std-rustls
- Sets Sea-Orm Migrations to use this runtime.runtime-tokio-native-tls
Default - Sets Sea-Orm Migrations to use this runtime.runtime-tokio-rustls
- Sets Sea-Orm Migrations to use this runtime.To run the tests for this. You will need Docker installed, and to start the Postgres Docker image first.
The exact steps to run the tests are ...
./scripts/start-postgres.sh
cargo test
./scripts/stop-postgres.sh