Testing a Runique Application

To avoid code duplication, Runique encourages using a shared server builder that starts a real instance of your application on a random free port.

use mon_projet::helpers::server::test_server_addr;

#[tokio::test]
async fn test_homepage_is_ok() {
    // 1. Get the shared server address (starts it on the first call)
    let addr = test_server_addr();
    
    // 2. Use reqwest (or any client) to call it
    let client = reqwest::Client::new();
    let resp = client.get(format!("http://{}/", addr)).await.unwrap();
    
    assert_eq!(resp.status(), 200);
}

For faster tests that don't require a real TCP server, you can use the oneshot builders. These call the Axum router directly in-memory.

use crate::helpers::{request, server::build_engine, server::build_default_router};

#[tokio::test]
async fn test_ping() {
    // Build the engine and router
    let engine = build_engine().await;
    let app = build_default_router(engine);
    
    // Standard GET
    let resp = request::get(app.clone(), "/").await;
    assert_eq!(resp.status(), 200);
    
    // POST with CSRF header
    let resp = request::post_with_header(app, "/submit", "x-csrf-token", "my-token").await;
    assert_eq!(resp.status(), 200);
}

The assert helper module provides readable macros to inspect HTTP responses:

use crate::helpers::assert::{assert_status, assert_redirect, assert_body_str};

#[tokio::test]
async fn test_login_flow() {
    let app = my_app_router();
    let resp = request::get(app, "/protected").await;
    
    // Check for redirection to login
    assert_redirect(&resp, "/login");
}

Runique provides fresh_db() which returns a new, isolated SQLite in-memory database for every test.

use crate::helpers::db;

#[tokio::test]
async fn test_database_persistence() {
    // Get a fresh, isolated DB
    let db = db::fresh_db().await;
    
    // Apply schema and run queries
    db::exec(&db, "CREATE TABLE demo (id INTEGER PRIMARY KEY, val TEXT)").await;
    db::exec(&db, "INSERT INTO demo (val) VALUES ('runique')").await;
    
    // Easy counting
    db::assert_count(&db, "demo", 1).await;
}