bb_api 0.5.2__tar.gz → 0.5.3__tar.gz

{bb_api-0.5.2 → bb_api-0.5.3}/PKG-INFO

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

{bb_api-0.5.2 → bb_api-0.5.3}/bb_api/__init__.py

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

{bb_api-0.5.2 → bb_api-0.5.3}/bb_api/accountability.py

@@ -761,6 +761,7 @@ class AccountabilityV3RepasseAPI(_AccountabilityV3BaseAPI):
         df = common.handle_results(
             extrato,
             main_list="listaLancamentosExtrato",
+            keep_header_when_empty=True,
             insertables=[
                 "numeroAgenciaRecebedora",
                 "digitoVerificadoraContaRecebedora",
@@ -913,6 +914,7 @@ class AccountabilityV3RepasseAPI(_AccountabilityV3BaseAPI):
         return common.handle_results(
             res,
             main_list="listaLancamentos",
+            keep_header_when_empty=True,
             insertables=[
                 "codigoProgramaGoverno",
                 "nomeProgramaGoverno",
@@ -1773,6 +1775,7 @@ class AccountabilityV3ControleAPI(_AccountabilityV3BaseAPI):
         df = common.handle_results(
             extrato,
             main_list="listaLancamentosExtrato",
+            keep_header_when_empty=True,
             insertables=[
                 "numeroAgenciaRecebedora",
                 "digitoVerificadoraContaRecebedora",
@@ -1922,6 +1925,7 @@ class AccountabilityV3ControleAPI(_AccountabilityV3BaseAPI):
         return common.handle_results(
             res,
             main_list="listaLancamentos",
+            keep_header_when_empty=True,
             insertables=[
                 "codigoProgramaGoverno",
                 "nomeProgramaGoverno",

{bb_api-0.5.2 → bb_api-0.5.3}/bb_api/common.py

@@ -81,11 +81,25 @@ def handle_results(
     insertables: Sequence[str] | None = None,
     explodeables: Sequence[str] | None = None,
     rename_dict: Mapping[str, str] | None = None,
+    *,
+    keep_header_when_empty: bool = False,
 ) -> pd.DataFrame:
+    """Monta o DataFrame da resposta: uma linha por item de ``main_list``.
+
+    Os campos de ``insertables`` ficam no nível de cima da resposta, fora da
+    lista, e são repetidos em todas as linhas.
+
+    Com ``keep_header_when_empty``, uma lista vazia devolve uma linha só com
+    esses campos, em vez de um DataFrame sem linha nenhuma. É o que preserva o
+    cabeçalho das respostas em que ele carrega o dado principal, como o
+    rendimento do mês nos extratos de aplicação.
+    """
     record = cast("Mapping[str, object]", data)
 
     if main_list is not None:
-        df = pd.DataFrame(cast("list[dict[Hashable, object]]", record[main_list]))
+        itens = cast("list[dict[Hashable, object]]", record.get(main_list) or [])
+        so_cabecalho = not itens and keep_header_when_empty
+        df = pd.DataFrame(index=[0]) if so_cabecalho else pd.DataFrame(itens)
     else:
         df = pd.DataFrame([dict(record)])
 

{bb_api-0.5.2 → bb_api-0.5.3}/bb_api.egg-info/PKG-INFO

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

{bb_api-0.5.2 → bb_api-0.5.3}/pyproject.toml

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