Testing Guide

cargo test --workspace --exclude roz-db --exclude roz-server

cargo t

docker run -d --name roz-test-db \
  -e POSTGRES_PASSWORD=test \
  -e POSTGRES_DB=roz_test \
  -p 5433:5432 postgres:16

export DATABASE_URL="postgres://postgres:test@localhost:5433/roz_test"
cargo test -p roz-db

cargo test -- --ignored --nocapture --test-threads=1

cargo e2e

use roz_test::nats::{nats_container, nats_url};

#[tokio::test]
async fn my_nats_test() {
    let _guard = nats_container().await;
    let url = nats_url().await;
    // url points to a fresh NATS container
}

// BAD: tests serde_json, not your code
let msg = json!({"type": "foo"});
assert_eq!(msg["type"], "foo");

// GOOD: tests the actual production code path
let msg = MyType::new("foo");
let json = serde_json::to_value(&msg).unwrap();
assert_eq!(json["type"], "foo");

// BAD: test requires a database connection
#[tokio::test]
async fn test_transform() {
    let db = setup_db().await;
    let raw = db.fetch("key").await;
    let result = transform(raw);
    assert_eq!(result, expected);
}

// GOOD: test the transform in isolation
#[test]
fn test_transform() {
    let raw = RawData { /* ... */ };
    let result = transform(raw);
    assert_eq!(result, expected);
}