sqlx 0.9.0

🧰 The Rust SQL Toolkit. An async, pure Rust SQL crate featuring compile-time checked queries without a DSL. Supports PostgreSQL, MySQL, and SQLite.
Documentation
use sqlx::{error::ErrorKind, mysql::MySql, Connection, Error};
use sqlx_test::new;

fn mysql_supports_check_constraints(version: &str) -> bool {
    if version.contains("MariaDB") {
        return true;
    }

    let numeric = match version.split(|c| c == '-' || c == ' ').next() {
        Some(numeric) => numeric,
        None => return false,
    };
    let mut parts = numeric.split('.');
    let major: u64 = match parts.next().and_then(|part| part.parse().ok()) {
        Some(major) => major,
        None => return false,
    };
    let minor: u64 = parts.next().unwrap_or("0").parse().unwrap_or_default();
    let patch: u64 = parts.next().unwrap_or("0").parse().unwrap_or_default();

    (major, minor, patch) >= (8, 0, 16)
}

#[sqlx_macros::test]
async fn it_fails_with_unique_violation() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let mut tx = conn.begin().await?;

    sqlx::query("INSERT INTO tweet(id, text, owner_id) VALUES (1, 'Foo', 1)")
        .execute(&mut *tx)
        .await?;

    let res: Result<_, sqlx::Error> = sqlx::query("INSERT INTO tweet VALUES (1, NOW(), 'Foo', 1);")
        .execute(&mut *tx)
        .await;
    let err = res.unwrap_err();

    let err = err.into_database_error().unwrap();

    assert_eq!(err.kind(), ErrorKind::UniqueViolation);

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_foreign_key_violation() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let mut tx = conn.begin().await?;

    let res: Result<_, sqlx::Error> =
        sqlx::query("INSERT INTO tweet_reply (tweet_id, text) VALUES (1, 'Reply!');")
            .execute(&mut *tx)
            .await;
    let err = res.unwrap_err();

    let err = err.into_database_error().unwrap();

    assert_eq!(err.kind(), ErrorKind::ForeignKeyViolation);

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_not_null_violation() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let mut tx = conn.begin().await?;

    let res: Result<_, sqlx::Error> = sqlx::query("INSERT INTO tweet (text) VALUES (null);")
        .execute(&mut *tx)
        .await;
    let err = res.unwrap_err();

    let err = err.into_database_error().unwrap();

    assert_eq!(err.kind(), ErrorKind::NotNullViolation);

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_check_violation() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let mut tx = conn.begin().await?;

    let version: String = sqlx::query_scalar("SELECT VERSION()")
        .fetch_one(&mut *tx)
        .await?;
    if !mysql_supports_check_constraints(&version) {
        return Ok(());
    }

    let res: Result<_, sqlx::Error> =
        sqlx::query("INSERT INTO products VALUES (1, 'Product 1', 0);")
            .execute(&mut *tx)
            .await;
    let err = res.unwrap_err();

    let err = err.into_database_error().unwrap();

    assert_eq!(err.kind(), ErrorKind::CheckViolation);

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_begin_failed() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let res = conn.begin_with("SELECT * FROM tweet").await;

    let err = res.unwrap_err();

    assert!(matches!(err, Error::BeginFailed), "{err:?}");

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_invalid_save_point_statement() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let mut txn = conn.begin().await?;
    let txn_conn = sqlx::Acquire::acquire(&mut txn).await?;
    let res = txn_conn.begin_with("BEGIN").await;

    let err = res.unwrap_err();

    assert!(matches!(err, Error::InvalidSavePointStatement), "{err}");

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_parameter_count_mismatch_too_few() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let res: Result<_, sqlx::Error> =
        sqlx::query("SELECT * FROM tweet WHERE id = ? AND owner_id = ?")
            .bind(1_i64)
            .execute(&mut conn)
            .await;

    let err = res.unwrap_err();

    assert!(matches!(err, Error::Protocol(_)), "{err}");

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_parameter_count_mismatch_too_many() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let res: Result<_, sqlx::Error> = sqlx::query("SELECT * FROM tweet WHERE id = ?")
        .bind(1_i64)
        .bind(2_i64)
        .execute(&mut conn)
        .await;

    let err = res.unwrap_err();

    assert!(matches!(err, Error::Protocol(_)), "{err}");

    Ok(())
}

#[sqlx_macros::test]
async fn it_fails_with_parameter_count_mismatch_zero_expected() -> anyhow::Result<()> {
    let mut conn = new::<MySql>().await?;
    let res: Result<_, sqlx::Error> = sqlx::query("SELECT COUNT(*) FROM tweet")
        .bind(1_i64)
        .execute(&mut conn)
        .await;

    let err = res.unwrap_err();

    assert!(matches!(err, Error::Protocol(_)), "{err}");

    Ok(())
}