Struct IntegrationTest 

pub struct IntegrationTest<H: Handler + 'static> { /* private fields */ }

Context for integration tests that manages fixtures and test client.

Provides a structured way to run multi-step integration tests with automatic fixture management and test isolation.

Example

use fastapi_core::testing::{IntegrationTest, TestFixture};
use std::sync::Arc;

// Define a fixture (e.g., for database state)
struct TestData {
    user_id: i64,
}

impl TestFixture for TestData {
    fn setup() -> Self {
        // Create test data
        TestData { user_id: 1 }
    }

    fn teardown(&mut self) {
        // Clean up test data
    }
}

#[test]
fn test_user_api() {
    let app = Arc::new(App::builder()
        .route("/users/{id}", Method::Get, get_user)
        .build());

    IntegrationTest::new("User API Test", app)
        .with_fixture::<TestData>()
        .run(|ctx| {
            // Access fixture
            let data = ctx.fixture::<TestData>().unwrap();

            // Make requests through the full app stack
            let response = ctx.get(&format!("/users/{}", data.user_id)).send();
            assert_eq!(response.status().as_u16(), 200);
        });
}

Implementations

impl<H: Handler + 'static> IntegrationTest<H>

pub fn new(name: impl Into<String>, handler: H) -> Self

Creates a new integration test context.

pub fn with_seed(name: impl Into<String>, handler: H, seed: u64) -> Self

Creates a new integration test with a specific seed for determinism.

pub fn with_fixture<F: TestFixture + 'static>(self) -> Self

Registers a fixture type for this test.

The fixture will be set up before the test runs and torn down after.

pub fn on_reset<F: Fn() + Send + Sync + 'static>(self, f: F) -> Self

Registers a state reset hook to run after the test.

Useful for clearing caches, resetting global state, etc.

pub fn run<F>(self, test_fn: F)

where F: FnOnce(&IntegrationTestContext<'_, H>) + UnwindSafe,

Runs the integration test.

The test function receives an IntegrationTestContext that provides access to the test client and fixtures.