tablas-python 0.1.3__tar.gz → 0.1.5__tar.gz

{tablas_python-0.1.3 → tablas_python-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tablas-python
-Version: 0.1.3
+Version: 0.1.5
 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 → tablas_python-0.1.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tablas-python"
-version = "0.1.3"
+version = "0.1.5"
 description = "Suite modular para extraer, transformar, conciliar y exportar tablas desde PDF, Excel y SQLite a pandas."
 readme = "README.md"
 authors = [

{tablas_python-0.1.3 → tablas_python-0.1.5}/tablas_python/__init__.py

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

{tablas_python-0.1.3 → tablas_python-0.1.5}/tablas_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tablas-python
-Version: 0.1.3
+Version: 0.1.5
 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 → tablas_python-0.1.5}/utils/data_helpers.py

@@ -14,27 +14,30 @@ import numpy as np
 # 1. PARSEO Y LIMPIEZA DE NÚMEROS Y FECHAS
 # ==========================================
 
-def limpiar_numero(val: Any) -> Union[float, int, Any]:
+def limpiar_numero(val: Any, default: Any = np.nan) -> Union[float, int, Any]:
     """
-    Convierte cualquier cadena con formato numérico, moneda o porcentaje a float o int.
-    Maneja formatos latinoamericanos (1.234,56) y anglosajones (1,234.56),
+    Convierte cualquier valor numérico, moneda o porcentaje a float o int de forma precisa.
+    Maneja formatos latinoamericanos (1.234,56 / 0,056), anglosajones (1,234.56 / 0.056),
     símbolos ($ / € / USD / CLP / %), y negativos entre paréntesis (100) -> -100.
     
     Ejemplos:
+        limpiar_numero("0,056")       -> 0.056
+        limpiar_numero("9,999")       -> 9.999
+        limpiar_numero("89,949")      -> 89.949
+        limpiar_numero("0,056%")      -> 0.056
         limpiar_numero("$ 1.250.000") -> 1250000.0
-        limpiar_numero("18,5 %")      -> 18.5
-        limpiar_numero("(450.50)")    -> -450.50
+        limpiar_numero("(450,50)")    -> -450.50
     """
     if pd.isna(val) or val is None:
-        return np.nan
+        return default
     if isinstance(val, (int, float, np.number)):
-        return val
+        return float(val) if isinstance(val, float) else val
 
     s = str(val).strip()
     if not s:
-        return np.nan
+        return default
 
-    # Detectar negativos con paréntesis: (123.45)
+    # 1. Detectar negativos con paréntesis: (123.45) o (123,45)
     es_negativo = False
     if s.startswith("(") and s.endswith(")"):
         es_negativo = True
@@ -43,46 +46,48 @@ def limpiar_numero(val: Any) -> Union[float, int, Any]:
         es_negativo = True
         s = s[1:].strip()
 
-    # Remover símbolos de monedas y palabras comunes
+    # 2. Remover símbolos de monedas y texto innecesario
     s = re.sub(r'[\$\€\£\¥\s]|USD|CLP|EUR|UF', '', s, flags=re.IGNORECASE)
     # Remover %
     s = s.replace('%', '').strip()
 
     if not s:
-        return np.nan
+        return default
 
-    # Determinar si el separador decimal es coma o punto
-    # Caso 1: Tiene comas y puntos (ej: 1.234.567,89 o 1,234,567.89)
+    # 3. Determinar separadores decimales y de miles
+    # Caso A: Tiene comas y puntos (ej: 1.234.567,89 o 1,234,567.89)
     if '.' in s and ',' in s:
         if s.rfind(',') > s.rfind('.'):
-            # Formato latino: 1.234,56 -> quitar puntos y coma a punto
+            # Formato latino: 1.234.567,89 -> quitar puntos y reemplazar coma por punto
             s = s.replace('.', '').replace(',', '.')
         else:
-            # Formato anglo: 1,234.56 -> quitar comas
+            # Formato anglo: 1,234,567.89 -> quitar comas
             s = s.replace(',', '')
+
+    # Caso B: Solo tiene coma(s)
     elif ',' in s:
-        # Solo tiene comas. Si tiene 1 coma y max 2 decimales al final: 1234,56
-        partes = s.split(',')
-        if len(partes) == 2 and len(partes[1]) <= 2:
+        num_comas = s.count(',')
+        if num_comas == 1:
+            # 1 sola coma: SIEMPRE es separador decimal en español (ej: 0,056 | 9,999 | 89,949 | 123,45)
             s = s.replace(',', '.')
         else:
-            # Es separador de miles: 1,000,000
+            # Múltiples comas: separador de miles anglosajón (ej: 1,000,000)
             s = s.replace(',', '')
+
+    # Caso C: Solo tiene punto(s)
     elif '.' in s:
-        # Solo tiene puntos. Si tiene múltiples puntos: 1.000.000
-        if s.count('.') > 1:
+        num_puntos = s.count('.')
+        if num_puntos > 1:
+            # Múltiples puntos: separador de miles latino (ej: 1.000.000)
             s = s.replace('.', '')
-        # Si tiene 1 punto y exactamente 3 dígitos después, puede ser miles (ej: 1.500)
-        # pero en float estándar suele ser decimal. Lo dejamos a float directo.
 
     try:
         num = float(s)
         if es_negativo:
             num = -num
-        # Si no tiene decimales reales, retornar float o int
         return num
     except ValueError:
-        return val
+        return default
 
 
 def limpiar_columnas_numericas(df: pd.DataFrame, columnas: Union[str, List[str]]) -> pd.DataFrame:
@@ -141,22 +146,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 +215,8 @@ def formatear_dataframe(
             'Ventas': 'moneda',
             'Precio': 'moneda_2dec',
             'Margen': 'porcentaje',
+            'Participacion': 'porcentaje_1dec',
+            'Ratio': 'ratio_pct',
             'Cantidad': 'miles'
         })
     """
@@ -188,7 +229,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