bb_api 0.5.4__tar.gz → 0.5.5__tar.gz

{bb_api-0.5.4 → bb_api-0.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bb_api
-Version: 0.5.4
+Version: 0.5.5
 Summary: Wrapper da API do Banco do Brasil.
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown

{bb_api-0.5.4 → bb_api-0.5.5}/bb_api/__init__.py

@@ -4,7 +4,7 @@ from importlib.metadata import PackageNotFoundError, version
 try:
     __version__ = version("bb_api")
 except PackageNotFoundError:
-    __version__ = "0.5.4"
+    __version__ = "0.5.5"
 
 
 from .common import Ambiente

{bb_api-0.5.4 → bb_api-0.5.5}/bb_api/accountability.py

@@ -22,6 +22,8 @@ _ERRO_INTERVALO_LONGO = "maior do que 31 dias"
 _STATUS_SEM_MOVIMENTO = 404
 _SEM_MOVIMENTO_PADRAO = "não há movimento no período consultado"
 
+_LIMITE_DO_CORPO = 500
+
 
 class RespostaError(Exception):
     """Resposta de erro devolvida pela API do Banco do Brasil.
@@ -29,15 +31,45 @@ class RespostaError(Exception):
     Carrega o status HTTP e a mensagem originais junto da ação que falhou. Sem
     eles, um ``404`` de "não há o que devolver", um ``403`` de escopo que falta
     e um ``400`` de parâmetro inválido chegam ao chamador iguais.
+
+    Quando recebe a ``resposta``, guarda também o corpo cru e o
+    ``x-request-id``: o corpo traz o ``codigo`` e a ``ocorrencia`` do BB, que a
+    mensagem sozinha perde, e é com eles que o suporte do banco rastreia a falha.
     """
 
     status_code: int
     mensagem: str
+    corpo: str
+    request_id: str | None
 
-    def __init__(self, acao: str, status_code: int, mensagem: str) -> None:
-        super().__init__(f"Não foi possível {acao} (HTTP {status_code}): {mensagem}")
+    def __init__(
+        self,
+        acao: str,
+        status_code: int,
+        mensagem: str,
+        *,
+        resposta: requests.Response | None = None,
+    ) -> None:
         self.status_code = status_code
         self.mensagem = mensagem
+        self.corpo = ""
+        self.request_id = None
+        if resposta is not None:
+            self.corpo = resposta.text.strip()
+            self.request_id = resposta.headers.get("x-request-id")
+        super().__init__(_descreve(acao, status_code, mensagem, self.corpo, self.request_id))
+
+
+def _descreve(
+    acao: str, status_code: int, mensagem: str, corpo: str, request_id: str | None
+) -> str:
+    partes = [f"Não foi possível {acao} (HTTP {status_code}): {mensagem}"]
+    if corpo and corpo != mensagem:
+        encurtado = corpo[:_LIMITE_DO_CORPO] + ("…" if len(corpo) > _LIMITE_DO_CORPO else "")
+        partes.append(f"resposta do BB: {encurtado}")
+    if request_id:
+        partes.append(f"x-request-id: {request_id}")
+    return " | ".join(partes)
 
 
 class ExtratoError(RespostaError):
@@ -47,8 +79,16 @@ class ExtratoError(RespostaError):
     API usa ``400`` tanto para falha de verdade quanto para situações normais.
     """
 
-    def __init__(self, status_code: int, mensagem: str) -> None:
-        super().__init__("reaver o extrato do órgão repassador", status_code, mensagem)
+    def __init__(
+        self,
+        status_code: int,
+        mensagem: str,
+        *,
+        resposta: requests.Response | None = None,
+    ) -> None:
+        super().__init__(
+            "reaver o extrato do órgão repassador", status_code, mensagem, resposta=resposta
+        )
 
 
 class SemLancamentosError(ExtratoError):
@@ -112,17 +152,17 @@ def _mensagem_da_lista_de_erros(campos: dict[str, object]) -> str:
 
 def _erro(acao: str, res: requests.Response) -> RespostaError:
     """Erro de uma resposta não-200, com a ação que falhou e o que o BB disse."""
-    return RespostaError(acao, res.status_code, _mensagem_de_erro(res))
+    return RespostaError(acao, res.status_code, _mensagem_de_erro(res), resposta=res)
 
 
 def _erro_extrato(res: requests.Response) -> ExtratoError:
     mensagem = _mensagem_de_erro(res)
     normalizada = mensagem.casefold()
     if _ERRO_SEM_LANCAMENTOS in normalizada:
-        return SemLancamentosError(res.status_code, mensagem)
+        return SemLancamentosError(res.status_code, mensagem, resposta=res)
     if _ERRO_INTERVALO_LONGO in normalizada:
-        return IntervaloLongoDemaisError(res.status_code, mensagem)
-    return ExtratoError(res.status_code, mensagem)
+        return IntervaloLongoDemaisError(res.status_code, mensagem, resposta=res)
+    return ExtratoError(res.status_code, mensagem, resposta=res)
 
 
 def _erro_extrato_aplicacao(res: requests.Response) -> ExtratoError:
@@ -134,7 +174,7 @@ def _erro_extrato_aplicacao(res: requests.Response) -> ExtratoError:
     """
     if res.status_code == _STATUS_SEM_MOVIMENTO:
         mensagem = _mensagem_de_erro(res) or _SEM_MOVIMENTO_PADRAO
-        return SemLancamentosError(res.status_code, mensagem)
+        return SemLancamentosError(res.status_code, mensagem, resposta=res)
     return _erro_extrato(res)
 
 

{bb_api-0.5.4 → bb_api-0.5.5}/bb_api.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bb_api
-Version: 0.5.4
+Version: 0.5.5
 Summary: Wrapper da API do Banco do Brasil.
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown

{bb_api-0.5.4 → bb_api-0.5.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "bb_api"
-version = "0.5.4"
+version = "0.5.5"
 description = "Wrapper da API do Banco do Brasil."
 readme = "README.md"
 requires-python = ">=3.13"