Organização de Testes

Testes organizados escalam com sua base de código: coloque testes unitários próximos ao código, compartilhe fixtures de integração e mantenha a configuração explícita para que cargo test paralelo permaneça confiável.

Receita

// tests/common/mod.rs
pub fn test_app() -> axum::Router {
    my_api::app_with_config(test_config())
}

// tests/orders.rs
mod common;
 
#[tokio::test]
async fn creates_order() {
    let app = common::test_app();
    // ...
}

Quando usar isso: Mais do que um punhado de testes de integração ou configuração repetida de banco de dados/API.

Exemplo de Trabalho

tests/
├── common/
│   ├── mod.rs
│   └── db.rs
├── orders.rs
└── users.rs

// tests/common/mod.rs
pub mod db;
 
use sqlx::PgPool;
 
pub async fn pool() -> PgPool {
    db::migrate_and_connect().await
}

// tests/orders.rs
mod common;
 
#[sqlx::test]
async fn inserts_order(pool: sqlx::PgPool) {
    let id = my_api::create_order(&pool, "sku-1").await.unwrap();
    assert!(id > 0);
}

O que isso demonstra:

• tests/common/mod.rs não é um crate de teste por si só
• mod common; compartilha helpers entre arquivos de integração
• #[sqlx::test] fornece configuração de banco de dados por teste
• Fixtures assíncronas permanecem em helpers assíncronos

Análise Profunda

Layout de Testes Unitários

Fixtures de Builder

pub struct OrderBuilder {
    sku: String,
}
 
impl OrderBuilder {
    pub fn new() -> Self {
        Self { sku: "default".into() }
    }
    pub fn sku(mut self, s: &str) -> Self {
        self.sku = s.into();
        self
    }
    pub fn build(self) -> Order {
        Order { sku: self.sku }
    }
}

• Builders reduzem a duplicação de configuração de teste
• Objeto válido padrão; substitua um campo por teste
• Mantém os testes legíveis: OrderBuilder::new().sku("x").build()

Armadilhas

• Pool estático global OnceLock - testes poluem uns aos outros. Correção: transações revertidas por teste ou #[serial_test::serial].
• tests/common.rs E tests/common/mod.rs - resolução de módulo confusa. Correção: escolha um layout e documente no README.
• Pânicos de Fixture - obscurecem qual teste falhou na configuração. Correção: retorne Result de helpers; use ? em testes.
• Configuração de cliente HTTP copiada e colada - desvio entre arquivos. Correção: helper test_app() com pilha de middleware compartilhada.
• Testes unitários em tests/ - não podem acessar API privada. Correção: mova o teste de lógica para src ou exponha helpers #[cfg(test)].

Alternativas

FAQs

Relacionados

• Testes Unitários vs. Integração - regras de posicionamento
• Mocking & Test Doubles - costuras de traits
• Testando Código Assíncrono - configuração do Tokio
• Cobertura & CI - layout do pipeline

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.