termo_core 0.1.21

Todos os clientes da Termotubos num crate só: um módulo por serviço e cada rota da API como uma função de uma linha, com o endereço resolvido pelo ambiente atual.
Documentation
use std::error::Error;
use std::fmt;

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ErroAoChamarServico {
    FalhaAoMontarRequisicao {
        nome_do_servico: &'static str,
        detalhe: String,
    },
    FalhaDeConexaoComOServico {
        nome_do_servico: &'static str,
        detalhe: String,
    },
    ServicoRespondeuComErro {
        nome_do_servico: &'static str,
        status_http: u16,
        /// O campo `erro` do corpo, quando o serviço responde no padrão `{ "erro": "..." }`.
        mensagem_de_erro: Option<String>,
        corpo_da_resposta: String,
    },
    RespostaDoServicoEmFormatoInesperado {
        nome_do_servico: &'static str,
        detalhe: String,
    },
}

impl ErroAoChamarServico {
    pub fn status_http_da_resposta(&self) -> Option<u16> {
        match self {
            ErroAoChamarServico::ServicoRespondeuComErro { status_http, .. } => Some(*status_http),
            _ => None,
        }
    }

    pub fn servico_nao_encontrou_o_registro(&self) -> bool {
        self.status_http_da_resposta() == Some(404)
    }

    pub fn vale_tentar_de_novo(&self) -> bool {
        match self {
            ErroAoChamarServico::FalhaDeConexaoComOServico { .. } => true,
            ErroAoChamarServico::ServicoRespondeuComErro { status_http, .. } => {
                matches!(status_http, 408 | 429 | 500..=599)
            }
            _ => false,
        }
    }
}

impl fmt::Display for ErroAoChamarServico {
    fn fmt(&self, formatador: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            ErroAoChamarServico::FalhaAoMontarRequisicao { nome_do_servico, detalhe } => {
                write!(formatador, "falha ao montar a requisição para o {nome_do_servico}: {detalhe}")
            }
            ErroAoChamarServico::FalhaDeConexaoComOServico { nome_do_servico, detalhe } => {
                write!(formatador, "falha de conexão com o {nome_do_servico}: {detalhe}")
            }
            ErroAoChamarServico::ServicoRespondeuComErro {
                nome_do_servico,
                status_http,
                mensagem_de_erro: Some(mensagem_de_erro),
                ..
            } => write!(formatador, "{nome_do_servico} respondeu {status_http}: {mensagem_de_erro}"),
            ErroAoChamarServico::ServicoRespondeuComErro {
                nome_do_servico,
                status_http,
                corpo_da_resposta,
                ..
            } => write!(formatador, "{nome_do_servico} respondeu {status_http}: {corpo_da_resposta}"),
            ErroAoChamarServico::RespostaDoServicoEmFormatoInesperado { nome_do_servico, detalhe } => {
                write!(formatador, "resposta do {nome_do_servico} em formato inesperado: {detalhe}")
            }
        }
    }
}

impl Error for ErroAoChamarServico {}