Skill de Tratamento de Erros

Design e refatorações de thiserror / anyhow - uma Skill de Agente para serviços e bibliotecas Rust 1.97.0.

O Que Esta Skill Faz

Refatora erros de string e cadeias de unwrap em enums thiserror em bibliotecas, anyhow::Result em binários, contexto via .context(), e mapeamentos IntoResponse do Axum. Adiciona implementações From e #[non_exhaustive] onde as APIs evoluem.

Quando Invocar

• PR introduz unwrap no caminho de produção
• Biblioteca expõe Box<dyn Error>
• HTTP 500 retorna mensagens internas brutas
• Migrando código legado de failure ou error-chain

Entradas

Saídas

• Módulo error.rs com enums tipados
• main retornando anyhow::Result
• Handler Result<T, AppError> com IntoResponse
• Casos de teste para redação de exibição de erro

Guardrails

1. Bibliotecas nunca usam anyhow em assinaturas públicas.
2. Sem expect em libs - retorne Result.
3. Contexto nos limites das operações - "carregando configuração", não em cada linha.
4. Redigir segredos em Display - implementação manual quando necessário.
5. Um único enum de erro por crate quando prático - evitar fragmentação.

Receita

rg 'unwrap\(|expect\(' src/ --type rust
cargo clippy -- -D clippy::unwrap_used
cargo test error_

Exemplo de Trabalho

use axum::{http::StatusCode, response::IntoResponse};
use thiserror::Error;
 
#[derive(Debug, Error)]
pub enum AppError {
    #[error("não encontrado")]
    NotFound,
    #[error(transparent)]
    Internal(#[from] anyhow::Error),
}
 
impl IntoResponse for AppError {
    fn into_response(self) -> axum::response::Response {
        let status = match self {
            AppError::NotFound => StatusCode::NOT_FOUND,
            AppError::Internal(_) => StatusCode::INTERNAL_SERVER_ERROR,
        };
        (status, self.to_string()).into_response()
    }
}

FAQs

Relacionados

• anyhow & thiserror
• Tipos de erro personalizados
• Regras de tratamento de erros
• Skill de Serviço Axum

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