luxorasap 0.2.12__tar.gz → 0.2.14__tar.gz

{luxorasap-0.2.12 → luxorasap-0.2.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luxorasap
-Version: 0.2.12
+Version: 0.2.14
 Summary: Toolbox da Luxor para ingestão, análise e automação de dados financeiros.
 Author-email: Luxor Group <backoffice@luxor.com.br>
 License: Proprietary – All rights reserved

{luxorasap-0.2.12 → luxorasap-0.2.14}/pyproject.toml

@@ -10,7 +10,7 @@ build-backend = "setuptools.build_meta"
 #############################
 [project]
 name            = "luxorasap"
-version = "0.2.12"
+version = "0.2.14"
 description     = "Toolbox da Luxor para ingestão, análise e automação de dados financeiros."
 readme          = "README.md"
 requires-python = ">=3.9"
@@ -78,7 +78,7 @@ exclude = ["tests*"]
 # bumpver (sem-ver)
 #############################
 [tool.bumpver]
-current_version = "0.2.12"
+current_version = "0.2.14"
 version_pattern = "MAJOR.MINOR.PATCH"
 
 # regex explícito – obrigatório no bumpver 2024+

{luxorasap-0.2.12 → luxorasap-0.2.14}/src/luxorasap/__init__.py

@@ -13,7 +13,7 @@ from types import ModuleType
 try:
     __version__: str = metadata.version(__name__)
 except metadata.PackageNotFoundError:  # editable install
-    __version__ = "0.2.12"
+    __version__ = "0.2.14"
 
 # ─── Lazy loader ─────────────────────────────────────────────────
 def __getattr__(name: str) -> ModuleType:

{luxorasap-0.2.12 → luxorasap-0.2.14}/src/luxorasap/ingest/cloud/__init__.py

@@ -60,6 +60,13 @@ def save_table(
         if index:
             df = df.reset_index().rename(columns={"index": index_name})
         _client_excel.write_excel(df, f"{directory}/{table_name}.xlsx")
+        
+    elif format == 'excel_multiple_sheets':
+        global _client_excel
+        if _client_excel is None:
+            _client_excel = BlobExcelClient()
+        # df neste caso é um dicionário de DataFrames
+        _client_excel.write_excel_multiple_sheets(df, f"{directory}/{table_name}.xlsx")
     
     elif format == 'pickle':
         global _client_pickle

{luxorasap-0.2.12 → luxorasap-0.2.14}/src/luxorasap/utils/storage/blob.py

@@ -157,6 +157,51 @@ class BlobExcelClient:
         self._container.upload_blob(name=blob_name, data=buf, overwrite=True)
 
 
+    def write_excel_multiple_sheets(
+        self,
+        sheets: dict[str, pd.DataFrame],
+        blob_name: str,
+        *,
+        index: bool = False,
+        engine: str = "openpyxl",
+        **to_excel_kwargs,
+    ) -> None:
+        """
+        Salva várias abas de uma planilha Excel no blob, a partir de um dicionário
+        {nome_aba: DataFrame}.
+
+        Args:
+            sheets: Mapa de nome da aba -> DataFrame.
+            blob_name: Caminho/nome do blob (ex.: "reports/minha_planilha.xlsx").
+            index: Se True, escreve o índice dos DataFrames.
+            engine: Engine do pandas.ExcelWriter (default "openpyxl").
+            **to_excel_kwargs: repassado a `DataFrame.to_excel` (ex.: na_format, float_format).
+        """
+
+        def _sanitize_sheet_name(name: str) -> str:
+            # Excel limita a 31 chars e proíbe alguns caracteres
+            s = str(name)[:31]
+            for ch, repl in {":": "_", "/": "_", "\\": "_", "?": "_", "*": "_", "[": "(", "]": ")"}.items():
+                s = s.replace(ch, repl)
+            return s
+
+        if not isinstance(sheets, dict) or not sheets:
+            raise ValueError("`sheets` deve ser um dicionário não vazio 'aba': 'DataFrame'.")
+
+        buf = io.BytesIO()
+        with pd.ExcelWriter(buf, engine=engine) as writer:
+            for sheet_name, df in sheets.items():
+                sanitized = _sanitize_sheet_name(sheet_name)
+                if not isinstance(df, pd.DataFrame):
+                    # tenta converter objetos "tabelares" em DataFrame
+                    df = pd.DataFrame(df)
+                df.to_excel(writer, sheet_name=sanitized, index=index, **to_excel_kwargs)
+
+        buf.seek(0)
+        self._container.upload_blob(name=blob_name, data=buf, overwrite=True)
+
+
+
     def read_excel(self, blob_name: str, **kwargs) -> pd.DataFrame:
         """
         Lê um arquivo Excel do blob e retorna um DataFrame.

{luxorasap-0.2.12 → luxorasap-0.2.14}/src/luxorasap.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: luxorasap
-Version: 0.2.12
+Version: 0.2.14
 Summary: Toolbox da Luxor para ingestão, análise e automação de dados financeiros.
 Author-email: Luxor Group <backoffice@luxor.com.br>
 License: Proprietary – All rights reserved