tablas-python 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

tablas_python/__init__.py

@@ -32,7 +32,7 @@ from utils.data_helpers import (
     conciliar_tablas,
 )
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"
 
 __all__ = [
     "TableManager",

{tablas_python-0.1.3.dist-info → tablas_python-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tablas-python
-Version: 0.1.3
+Version: 0.1.4
 Summary: Suite modular para extraer, transformar, conciliar y exportar tablas desde PDF, Excel y SQLite a pandas.
 Author: Reciba
 License: MIT

{tablas_python-0.1.3.dist-info → tablas_python-0.1.4.dist-info}/RECORD

@@ -1,12 +1,12 @@
 helpers/__init__.py,sha256=hopndlywciR50FKi6W6Lo_cAOP_YyPsQV3xj8hfkH_Y,899
 helpers/display_helper.py,sha256=i0--Txkjc9__IIKwdkmpx98vzwM_Sekr0RzxvVGEPYA,7749
 helpers/table_manager.py,sha256=85OZqMdDqgBBJaln2ehb3-t7RWS1Gowo6aud_zqVHAo,19063
-tablas_python/__init__.py,sha256=Y-L9T9fn7gBiZdkXJ-qI9pe6bh7frMG71hgcqqcOqqM,1771
+tablas_python/__init__.py,sha256=xVyYUKPzia_CaMiVFM_WxtIBx-8Y06ltIAWFD0U-cVY,1771
 tablas_python/cli.py,sha256=3BModRFfT8WFkbCSxM9cF_oBK87FetPMGm5F0GTZGNo,1957
-tablas_python-0.1.3.dist-info/licenses/LICENSE,sha256=DQi0EoD04d2_-pnEKrC4WmcmgR6O0WQcJdvma9ILoFQ,1063
+tablas_python-0.1.4.dist-info/licenses/LICENSE,sha256=DQi0EoD04d2_-pnEKrC4WmcmgR6O0WQcJdvma9ILoFQ,1063
 utils/__init__.py,sha256=duEZSrdPZggUMdpJqJsNMQ5aLRaFcONBvhsdJuhCToo,2004
 utils/batch_processor.py,sha256=rE59qkb2sp5J0E5NU77U-CF82Aa-ukrjN2druwgS2Uk,4162
-utils/data_helpers.py,sha256=oJx5NPTpCNTHVvSCpqVeTnWGJsflYKl5v6lLUov08Hs,21758
+utils/data_helpers.py,sha256=U6RTiJd0NpqYtk8kQa37jaJBMCay0CUnduREjaoPLM0,23526
 utils/excel_extractor.py,sha256=0WUhkV5eu9uUusU8zSHQB1ujFG7eQVqI-go4zqxmPFU,18364
 utils/excel_writer.py,sha256=zH_Mtu3Cr_ND_wSHKFyvzH3j16gjVoANpM3dVFXKpr0,6991
 utils/exporter.py,sha256=Oo9Y6dXTg_7t6n824xoxv8d9yuhdHZNWfwLLXvSvtMw,4661
@@ -15,8 +15,8 @@ utils/pdf_extractor.py,sha256=3JRMqnEfhBVaUOeYfiNH1rReC4EoSbzDwk919x6647w,4768
 utils/sqlite_extractor.py,sha256=mvKlKY-nsd5cV73nn3xFoqg5dgagPJceRDJfPLG0cbs,5033
 utils/table_cleaner.py,sha256=ncyiunqpVdKParFcRKwQbCqyKZgpyKRN0aUM0Oug9wU,10465
 utils/validator.py,sha256=0UywK_D510ZQCcSkhFRKhEuw48788NM_RFVC-bIFZkE,5837
-tablas_python-0.1.3.dist-info/METADATA,sha256=rJMNr3NxGAcFwaz4xgAdmZ6IKJbCHPqiKXJGF4tG2MY,13611
-tablas_python-0.1.3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-tablas_python-0.1.3.dist-info/entry_points.txt,sha256=l29nooItcUpsFzN5LmxM1b-j0qih61vJB9tX8KUwlMg,89
-tablas_python-0.1.3.dist-info/top_level.txt,sha256=Foud-Tbf5pviUJmp7wc3v24IjIyypkvbcZt7HkrWvss,28
-tablas_python-0.1.3.dist-info/RECORD,,
+tablas_python-0.1.4.dist-info/METADATA,sha256=jpBHw3DHlXyFY2qoyOofl65SS0PTXuvRATwthrL0qZI,13611
+tablas_python-0.1.4.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+tablas_python-0.1.4.dist-info/entry_points.txt,sha256=l29nooItcUpsFzN5LmxM1b-j0qih61vJB9tX8KUwlMg,89
+tablas_python-0.1.4.dist-info/top_level.txt,sha256=Foud-Tbf5pviUJmp7wc3v24IjIyypkvbcZt7HkrWvss,28
+tablas_python-0.1.4.dist-info/RECORD,,

utils/data_helpers.py

@@ -141,22 +141,56 @@ def formato_moneda(val: Any, simbolo: str = "$", decimales: int = 0, separador_m
     return f"{simbolo} {texto}" if simbolo else texto
 
 
-def formato_porcentaje(val: Any, decimales: int = 1) -> str:
+def formato_porcentaje(
+    val: Any,
+    decimales: Optional[int] = None,
+    multiplicar_por_100: bool = False,
+    separador_decimal: str = ","
+) -> str:
     """
-    Formatea un valor a porcentaje.
-    Ejemplo:
-        formato_porcentaje(15.42) -> "15.4%"
-        formato_porcentaje(0.1542, es_ratio=True)
+    Formatea un valor a porcentaje de manera exacta.
+    
+    A diferencia de versiones anteriores, NO multiplica arbitrariamente por 100
+    a menos que se indique explícitamente con `multiplicar_por_100=True`.
+    Por lo tanto, 0.056 se muestra como 0,056% y 5.56 se muestra como 5,56%.
+    
+    Ejemplos:
+        formato_porcentaje(5.56)                     -> "5,56%"
+        formato_porcentaje(0.056)                    -> "0,056%"
+        formato_porcentaje("0.056%")                 -> "0,056%"
+        formato_porcentaje(0.056, multiplicar_por_100=True)  -> "5,6%"
+        formato_porcentaje(15.42, decimales=1)       -> "15,4%"
     """
+    if pd.isna(val) or val is None or str(val).strip() == "":
+        return ""
+
+    s_orig = str(val).strip()
+    tenia_simbolo_pct = "%" in s_orig
+
     num = limpiar_numero(val)
     if pd.isna(num) or not isinstance(num, (int, float)):
-        return "" if pd.isna(val) else str(val)
-    
-    # Si el valor está entre 0 y 1 (ratio), convertir a base 100
-    if -1.0 <= num <= 1.0 and num != 0:
+        return s_orig
+
+    # Solo multiplicar por 100 si el usuario lo pide explícitamente y el valor NO traía ya el '%'
+    if multiplicar_por_100 and not tenia_simbolo_pct:
         num = num * 100
 
-    return f"{num:.{decimales}f}%"
+    if decimales is not None:
+        fmt_str = f"{{:.{decimales}f}}"
+        txt_num = fmt_str.format(num)
+    else:
+        # Conservar los decimales significativos del número sin truncar
+        if isinstance(num, int) or (isinstance(num, float) and num.is_integer()):
+            txt_num = str(int(num))
+        else:
+            txt_num = f"{num:.6f}".rstrip('0').rstrip('.')
+
+    if separador_decimal == ",":
+        txt_num = txt_num.replace(".", ",")
+    else:
+        txt_num = txt_num.replace(",", ".")
+
+    return f"{txt_num}%"
 
 
 def formato_miles(val: Any, decimales: int = 0) -> str:
@@ -176,6 +210,8 @@ def formatear_dataframe(
             'Ventas': 'moneda',
             'Precio': 'moneda_2dec',
             'Margen': 'porcentaje',
+            'Participacion': 'porcentaje_1dec',
+            'Ratio': 'ratio_pct',
             'Cantidad': 'miles'
         })
     """
@@ -188,7 +224,13 @@ def formatear_dataframe(
         elif tipo == 'moneda_2dec':
             df_out[col] = df_out[col].apply(lambda x: formato_moneda(x, decimales=2))
         elif tipo == 'porcentaje':
-            df_out[col] = df_out[col].apply(formato_porcentaje)
+            df_out[col] = df_out[col].apply(lambda x: formato_porcentaje(x))
+        elif tipo == 'porcentaje_1dec':
+            df_out[col] = df_out[col].apply(lambda x: formato_porcentaje(x, decimales=1))
+        elif tipo == 'porcentaje_2dec':
+            df_out[col] = df_out[col].apply(lambda x: formato_porcentaje(x, decimales=2))
+        elif tipo == 'ratio_pct':
+            df_out[col] = df_out[col].apply(lambda x: formato_porcentaje(x, multiplicar_por_100=True, decimales=1))
         elif tipo == 'miles':
             df_out[col] = df_out[col].apply(formato_miles)
     return df_out