Axum Service Skill

Geração e revisão idiomática de serviços web Axum 0.8 - uma Skill de Agente para Rust 1.97.0, Tokio 1.x e serde 1.0.

O Que Esta Skill Faz

Produz uma checklist de serviço HTTP implantável: workspace Cargo.toml, módulos Router, AppState compartilhado (PgPool, reqwest::Client), rotas /health e /ready, subscriber tracing, erros de domínio thiserror mapeados para códigos de status e testes de integração com tower::ServiceExt.

Quando Invocar

• Novo microserviço ou BFF em um workspace Rust
• Revisando PRs para chamadas de banco de dados bloqueantes em handlers assíncronos
• Dividindo um binário monolítico em módulos roteados
• Padronizando código Axum de hackathons antes da produção

Entradas

Saídas

• Cargo.toml com axum, tokio, tower-http, tracing, serde, sqlx opcional
• src/main.rs com TcpListener, desligamento gracioso
• src/routes/mod.rs, health.rs, roteadores de domínio
• src/error.rs com mapeamento IntoResponse
• tests/health.rs usando requisições oneshot
• Bloco de comando de verificação

Guardrails

1. Handlers assíncronos não devem bloquear - use spawn_blocking ou DB assíncrono apenas.
2. Sem segredos nos arquivos gerados - apenas placeholders .env.example.
3. Rotas de health antes das rotas de domínio - balanceadores de carga precisam delas desde o primeiro dia.
4. tracing estruturado - #[instrument] em handlers; sem println! em caminhos de produção.
5. Clonar estado barato - Arc<PgPool> e reqwest::Client reutilizado.
6. Mapear erros para status - nunca vazar strings internas em 500 em APIs públicas.

Receita

cd services/billing-api
cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings
cargo test
cargo run &
curl -sf http://localhost:3000/health
curl -sf http://localhost:3000/ready

Exemplo de Trabalho (esqueleto)

use axum::{routing::get, Router};
use std::net::SocketAddr;
use tokio::net::TcpListener;
 
mod routes;
 
#[tokio::main]
async fn main() -> anyhow::Result<()> {
    tracing_subscriber::fmt::init();
    let app = Router::new()
        .merge(routes::health::router());
    let addr = SocketAddr::from(([0, 0, 0, 0], 3000));
    let listener = TcpListener::bind(addr).await?;
    axum::serve(listener, app).await?;
    Ok(())
}

FAQs

Relacionado

• Básicos do Axum
• reqwest & sqlx
• Skill Async / Tokio
• Skill de Tratamento de Erros

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+.