luxorasap 0.2.12__py3-none-any.whl → 0.2.14__py3-none-any.whl

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/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/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.dist-info → luxorasap-0.2.14.dist-info}/METADATA

@@ -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.dist-info → luxorasap-0.2.14.dist-info}/RECORD

@@ -1,4 +1,4 @@
-luxorasap/__init__.py,sha256=qmCFLnriRBLL3UlKCDNcng-JHSehVikZtOteu-NME5U,1356
+luxorasap/__init__.py,sha256=xDbLsrCmxU8ikmmC0bupvVN_t_PEOd9NrREMfq9AH9I,1356
 luxorasap/btgapi/__init__.py,sha256=QUlfb5oiBY6K1Q5x4-a-x2wECe1At5wc2962I5odOJk,620
 luxorasap/btgapi/auth.py,sha256=PvyCtbEyBO2B1CIeAlNXWugKW1OgiKfPcVzS6K5FBnQ,1872
 luxorasap/btgapi/reports.py,sha256=ZVEMLoJPXc0r3XjPJPMsKQN0zZd1Npd7umNpAj1bncs,8040
@@ -6,19 +6,19 @@ luxorasap/btgapi/trades.py,sha256=956HZ9BvN9C_VQvKTyBLN0x6ZygwVqBZN11F7OnNbDI,59
 luxorasap/datareader/__init__.py,sha256=41RAvbrQ4R6oj67S32CrKqolx0CJ2W8cbOF6g5Cqm2g,120
 luxorasap/datareader/core.py,sha256=D7nNdKiu5VAii4xWnoqO1PR0qaYi3YEfKyxhkVGZ1j8,158784
 luxorasap/ingest/__init__.py,sha256=gHkw8FU8TuRL5tfHkACxwsLHwLYX8SgX9xHkB8uTjww,831
-luxorasap/ingest/cloud/__init__.py,sha256=I0JZh9FbGnIVxu7VmiTXe8rKN_w5OWLULvkVkVZNeUk,7242
+luxorasap/ingest/cloud/__init__.py,sha256=zoepoVcXNFtVj62aUyqu9AY7u6vX0RIKRWDfXOn2J4Q,7548
 luxorasap/ingest/legacy_local/dataloader.py,sha256=DF3CvojDAi0itVDZPsQbmpl5pqMTNwOOpxTz4Ju8mho,12419
 luxorasap/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 luxorasap/utils/dataframe/__init__.py,sha256=heKpmq58FmX35syzzwrHqlOWKYBkH2Z1jyqaQ_Vg-00,265
 luxorasap/utils/dataframe/reader.py,sha256=Vzjdw-AeS1lnWEHQ8RZNh0kK93NWTp0NWVi_B6mN5N0,616
 luxorasap/utils/dataframe/transforms.py,sha256=OIvlTTcjFX6bUhuQp_syEp7ssm4sLzwvgsag6n2Wl3k,2438
 luxorasap/utils/storage/__init__.py,sha256=461GYJcPMXGjHuJ9y9D3BHOC_oUS9Re32nVu1AwKyIA,334
-luxorasap/utils/storage/blob.py,sha256=vgCKMOiVgP-V1A2xZRhG3kJhPFU-LA9E9kddOQTxYD8,9443
+luxorasap/utils/storage/blob.py,sha256=28bsUbEUjg_LapDZ4P3kWkxHDQGNXv_Jik49RfXbwME,11223
 luxorasap/utils/storage/change_tracker.py,sha256=HkeKc62UyD2BtP2gqafnJHZSBvYreH_7SQI1CYhn3Us,11709
 luxorasap/utils/tools/__init__.py,sha256=dvK7Z4xnNQAuEiObVN7qjeLWAvP49JeFn2Oq9GdgmXs,76
 luxorasap/utils/tools/excel.py,sha256=SfeTcbJWsWq3uKruwKSjJ4aWgMovITzlNXjP2bhdMjI,1246
-luxorasap-0.2.12.dist-info/METADATA,sha256=NfuDMRUJjqpXvliK93mzJicsmHNrsdnidGVPQOW1zeA,3804
-luxorasap-0.2.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-luxorasap-0.2.12.dist-info/entry_points.txt,sha256=XFh-dOwUhlya9DmGvgookMI0ezyUJjcOvTIHDEYS44g,52
-luxorasap-0.2.12.dist-info/top_level.txt,sha256=9YOL6bUIpzY06XFBRkUW1e4rgB32Ds91fQPGwUEjxzU,10
-luxorasap-0.2.12.dist-info/RECORD,,
+luxorasap-0.2.14.dist-info/METADATA,sha256=smLlV2FPeq9rNwPCAgNb2AYfy6tPqMLlKlE78kJUoaw,3804
+luxorasap-0.2.14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+luxorasap-0.2.14.dist-info/entry_points.txt,sha256=XFh-dOwUhlya9DmGvgookMI0ezyUJjcOvTIHDEYS44g,52
+luxorasap-0.2.14.dist-info/top_level.txt,sha256=9YOL6bUIpzY06XFBRkUW1e4rgB32Ds91fQPGwUEjxzU,10
+luxorasap-0.2.14.dist-info/RECORD,,