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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tablas-python
-Version: 0.1.5
+Version: 0.1.7
 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.5 → tablas_python-0.1.7}/helpers/__init__.py

@@ -7,7 +7,7 @@ from .display_helper import DisplayHelper, mostrar_tabla
 from utils.batch_processor import unir_archivos_carpeta
 from utils.excel_writer import escribir_en_excel
 from utils.validator import validar_dataframe, reporte_calidad, detectar_duplicados
-from utils.data_helpers import buscar_v, conciliar_tablas, obtener_celda, modificar_celda
+from utils.data_helpers import buscar_v, conciliar_tablas, obtener_celda, modificar_celda, formato_clp, formato_porcentaje, formato_moneda
 
 __all__ = [
     "TableManager",
@@ -23,6 +23,9 @@ __all__ = [
     "conciliar_tablas",
     "obtener_celda",
     "modificar_celda",
+    "formato_clp",
+    "formato_porcentaje",
+    "formato_moneda",
     "DisplayHelper",
     "mostrar_tabla",
 ]

{tablas_python-0.1.5 → tablas_python-0.1.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tablas-python"
-version = "0.1.5"
+version = "0.1.7"
 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.5 → tablas_python-0.1.7}/tablas_python/__init__.py

@@ -18,6 +18,7 @@ from utils.data_helpers import (
     limpiar_columnas_numericas,
     normalizar_fechas,
     formato_moneda,
+    formato_clp,
     formato_porcentaje,
     formato_miles,
     formatear_dataframe,
@@ -32,7 +33,7 @@ from utils.data_helpers import (
     conciliar_tablas,
 )
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"
 
 __all__ = [
     "TableManager",
@@ -54,6 +55,7 @@ __all__ = [
     "limpiar_columnas_numericas",
     "normalizar_fechas",
     "formato_moneda",
+    "formato_clp",
     "formato_porcentaje",
     "formato_miles",
     "formatear_dataframe",

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

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

@@ -17,6 +17,7 @@ from .data_helpers import (
     limpiar_columnas_numericas,
     normalizar_fechas,
     formato_moneda,
+    formato_clp,
     formato_porcentaje,
     formato_miles,
     formatear_dataframe,
@@ -56,6 +57,7 @@ __all__ = [
     "limpiar_columnas_numericas",
     "normalizar_fechas",
     "formato_moneda",
+    "formato_clp",
     "formato_porcentaje",
     "formato_miles",
     "formatear_dataframe",

{tablas_python-0.1.5 → tablas_python-0.1.7}/utils/data_helpers.py

@@ -14,17 +14,20 @@ import numpy as np
 # 1. PARSEO Y LIMPIEZA DE NÚMEROS Y FECHAS
 # ==========================================
 
-def limpiar_numero(val: Any, default: Any = np.nan) -> Union[float, int, Any]:
+def limpiar_numero(val: Any, default: Any = 0) -> Union[float, int, Any]:
     """
     Convierte cualquier valor numérico, moneda o porcentaje a float o int de forma precisa.
+    Si el valor está vacío, es nulo o texto sin número (ej: '-', 'N/A', 'null'), retorna 0 (o el default indicado).
+    
     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("")            -> 0
+        limpiar_numero("-")           -> 0
+        limpiar_numero("N/A")         -> 0
+        limpiar_numero(None)          -> 0
         limpiar_numero("$ 1.250.000") -> 1250000.0
         limpiar_numero("(450,50)")    -> -450.50
     """
@@ -34,7 +37,7 @@ def limpiar_numero(val: Any, default: Any = np.nan) -> Union[float, int, Any]:
         return float(val) if isinstance(val, float) else val
 
     s = str(val).strip()
-    if not s:
+    if not s or s.lower() in ['', '-', '--', 'n/a', 'na', 'null', 'none', 's/i', 's/n']:
         return default
 
     # 1. Detectar negativos con paréntesis: (123.45) o (123,45)
@@ -80,6 +83,13 @@ def limpiar_numero(val: Any, default: Any = np.nan) -> Union[float, int, Any]:
         if num_puntos > 1:
             # Múltiples puntos: separador de miles latino (ej: 1.000.000)
             s = s.replace('.', '')
+        else:
+            # 1 solo punto (ej: 250.000, 39.990 vs 0.056, 12.5)
+            partes = s.split('.')
+            if len(partes) == 2:
+                # Si no empieza con '0' y tiene exactamente 3 dígitos tras el punto, es separador de miles (ej: 250.000)
+                if partes[0] not in ['0', '-0'] and len(partes[1]) == 3:
+                    s = s.replace('.', '')
 
     try:
         num = float(s)
@@ -90,17 +100,22 @@ def limpiar_numero(val: Any, default: Any = np.nan) -> Union[float, int, Any]:
         return default
 
 
-def limpiar_columnas_numericas(df: pd.DataFrame, columnas: Union[str, List[str]]) -> pd.DataFrame:
+def limpiar_columnas_numericas(
+    df: pd.DataFrame,
+    columnas: Union[str, List[str]],
+    rellenar_nulos: Any = 0
+) -> pd.DataFrame:
     """
-    Convierte una o más columnas a tipo numérico (float) limpiando caracteres extra.
+    Convierte una o más columnas a tipo numérico (float) limpiando caracteres extra
+    y rellenando valores vacíos o nulos con 0 (o el valor indicado).
     """
     df_out = df.copy()
     if isinstance(columnas, str):
         columnas = [columnas]
     for col in columnas:
         if col in df_out.columns:
-            df_out[col] = df_out[col].apply(limpiar_numero)
-            df_out[col] = pd.to_numeric(df_out[col], errors='coerce')
+            df_out[col] = df_out[col].apply(lambda x: limpiar_numero(x, default=rellenar_nulos))
+            df_out[col] = pd.to_numeric(df_out[col], errors='coerce').fillna(rellenar_nulos)
     return df_out
 
 
@@ -146,6 +161,18 @@ def formato_moneda(val: Any, simbolo: str = "$", decimales: int = 0, separador_m
     return f"{simbolo} {texto}" if simbolo else texto
 
 
+def formato_clp(val: Any, simbolo: str = "$") -> str:
+    """
+    Formatea un número o texto a Pesos Chilenos (CLP) con separador de miles y sin decimales.
+    
+    Ejemplos:
+        formato_clp(1500000)              -> "$ 1.500.000"
+        formato_clp("1500000")            -> "$ 1.500.000"
+        formato_clp(250000, simbolo="CLP") -> "CLP 250.000"
+    """
+    return formato_moneda(val, simbolo=simbolo, decimales=0, separador_miles=".")
+
+
 def formato_porcentaje(
     val: Any,
     decimales: Optional[int] = None,
@@ -224,10 +251,14 @@ def formatear_dataframe(
     for col, tipo in reglas.items():
         if col not in df_out.columns:
             continue
-        if tipo == 'moneda':
-            df_out[col] = df_out[col].apply(lambda x: formato_moneda(x, decimales=0))
+        if tipo in ['moneda', 'clp', 'moneda_clp']:
+            df_out[col] = df_out[col].apply(lambda x: formato_clp(x))
         elif tipo == 'moneda_2dec':
             df_out[col] = df_out[col].apply(lambda x: formato_moneda(x, decimales=2))
+        elif tipo == 'usd':
+            df_out[col] = df_out[col].apply(lambda x: formato_moneda(x, simbolo="USD $", decimales=2, separador_miles=","))
+        elif tipo == 'uf':
+            df_out[col] = df_out[col].apply(lambda x: formato_moneda(x, simbolo="UF", decimales=2, separador_miles="."))
         elif tipo == 'porcentaje':
             df_out[col] = df_out[col].apply(lambda x: formato_porcentaje(x))
         elif tipo == 'porcentaje_1dec':