eco-back 0.2.1__py3-none-any.whl → 0.2.2__py3-none-any.whl

eco_back/__init__.py

@@ -2,12 +2,13 @@
 eco-back - Librería Python
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 # Módulos principales
 from . import database
 from . import api
 from . import documento
 from . import registro
+from . import utils
 
-__all__ = ["database", "api", "documento", "registro", "__version__"]
+__all__ = ["database", "api", "documento", "registro", "utils", "__version__"]

eco_back/registro/trazabilidad.py

@@ -1,3 +1,5 @@
+from eco_back.utils.exceptions import ServiceValidationError, handle_service_validation_error
+from eco_back.utils.logger_generico import _log_warn
 from rest_framework.decorators import api_view, renderer_classes
 from django.views.decorators.csrf import csrf_exempt
 from rest_framework.renderers import JSONRenderer
@@ -6,8 +8,6 @@ from registro.models.models_global import Trazabilidad
 from registro.serializer.serializer_get import TrazabilidadSerializer
 from rest_framework.response import Response
  
-from utils.guardado_datos.exceptions import ServiceValidationError, ServiceValidationError, handle_service_validation_error
-from utils.logger_generico import _log_warn
  
  
 @csrf_exempt

eco_back/utils/__init__.py

@@ -0,0 +1,13 @@
+"""
+Módulo de utilidades para eco-back
+Incluye manejo de excepciones y logging
+"""
+
+from .exceptions import ServiceValidationError, handle_service_validation_error
+from .logger_generico import _log_warn
+
+__all__ = [
+    "ServiceValidationError",
+    "handle_service_validation_error",
+    "_log_warn"
+]

eco_back/utils/exceptions.py

@@ -0,0 +1,46 @@
+# Raise custom exception for service validation errors
+# - Envía un mensaje y un código HTTP asociado
+import datetime
+from functools import wraps
+from django.http import JsonResponse
+
+from eco_back.utils.logger_generico import _log_warn
+
+class ServiceValidationError(Exception):
+    def __init__(self, message: str, code: int = 400, errors=None, extra=None, context=None, user_id=None, request_path=None):
+        super().__init__(message)
+        self.message = message
+        self.code = code
+        self.errors = errors
+        self.extra = extra
+        self.context = context
+        self.user_id = user_id
+        self.request_path = request_path
+        self.timestamp = datetime.datetime.now().isoformat()
+
+def handle_service_validation_error(view_func):
+    @wraps(view_func)
+    def _wrapped_view(request, *args, **kwargs):
+        try:
+            return view_func(request, *args, **kwargs)
+        except ServiceValidationError as e:
+            _log_warn(f"Error: {e.message}", level="warning", extra={"errors": e.errors, "extra": e.extra, "context": e.context}, exc_info=True)
+            resp = {"status": "error", "message": e.message}
+            if e.errors:
+                resp["errors"] = e.errors
+            if e.extra:
+                resp["extra"] = e.extra
+            if e.context:
+                resp["context"] = e.context
+            if e.user_id:
+                resp["user_id"] = e.user_id
+            if e.request_path:
+                resp["request_path"] = e.request_path
+
+            resp["timestamp"] = e.timestamp
+            return JsonResponse(resp, status=e.code)
+        except Exception as e:
+            _log_warn(f"Error inesperado en decorator: {e}", level="error", exc_info=True, extra={"view": view_func.__name__})
+            print(f"handle_service_validation_error atrapó excepción: {e}")
+            return JsonResponse({"status": "error", "message": "Error interno"}, status=500)
+    return _wrapped_view

eco_back/utils/logger_generico.py

@@ -0,0 +1,107 @@
+import logging
+import inspect
+logger = logging.getLogger(__name__)
+
+# Mensajes
+def _log_warn(msg, level='info', exc_info=False, extra=None):
+    """
+    Registrar mensajes usando el logger configurado.
+
+    Parámetros:
+      msg: mensaje (se convierte a str).
+      level: nivel de log ('debug','info','warning','error','critical' o int). Default 'info'.
+      exc_info: bool o excepción para incluir traceback. Default False.
+      extra: dict opcional para pasar como extra al logger.
+
+    Llamadas anteriores _log_warn(msg) siguen funcionando y producirán un INFO por defecto.
+    """
+    # compatibilidad: si se llama con un solo argumento, funciona como antes (INFO)
+    try:
+        # obtener frame llamante de forma ligera
+        frm = inspect.currentframe()
+        caller = frm.f_back if frm is not None else None
+        mod = inspect.getmodule(caller) if caller is not None else None
+        logger_name = mod.__name__ if mod and hasattr(mod, '__name__') else __name__
+        logger = logging.getLogger(logger_name)
+
+        extra = extra or {}
+        lvl = level.lower() if isinstance(level, str) else None
+
+        if isinstance(level, str):
+            lvl = level.lower()
+            if lvl == 'debug':
+                logger.debug("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+            elif lvl == 'info':
+                logger.info("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+            elif lvl in ('warn', 'warning'):
+                logger.warning("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+            elif lvl == 'error':
+                logger.error("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+            elif lvl == 'critical':
+                logger.critical("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+            else:
+                logger.info("%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+        else:
+            # nivel numérico
+            logger.log(int(level), "%s", str(msg), exc_info=exc_info, **({'extra': extra} if extra else {}))
+    except Exception:
+        try:
+            logging.getLogger(__name__).error("Error al loggear mensaje: %s", str(msg), exc_info=True)
+        except Exception:
+            # fallback: siempre imprimir por stdout/stderr para depuración inmediata
+            try:
+                import sys, traceback
+                print("[LOGGER-ERROR] Error al loggear mensaje:", str(msg), file=sys.stderr)
+                traceback.print_exc()
+            except Exception:
+                pass
+            pass
+
+# Usos de _log_warn
+'''
+# Mensaje simple (por compatibilidad -> level='info')
+_log_warn("Inicio del proceso")
+
+
+# Nivel explícito
+_log_warn("Campo faltante en payload", level="warning")
+_log_warn("Operación completada", level="debug")
+
+
+# Con exception traceback dentro de un except
+try:
+    # hacer_algo()
+    print(1) # ejemplo que lanza excepción
+except Exception as e:
+    _log_warn(f"Error al ejecutar hacer_algo: {e}", level="error", exc_info=True)
+
+
+# Loggear estructuras (dict/list) de forma legible
+import json
+data = {"usuario": "juan", "roles": ["admin", "analista"]}
+_log_warn(json.dumps(data, ensure_ascii=False), level="info")
+
+
+# o directamente (se convierte a str internamente)
+_log_warn(data, level="debug")
+
+
+# Loggear una instancia Django (recomendado convertir a dict)
+from django.forms.models import model_to_dict
+instancia_modelo = ...  # instancia de un modelo Django
+_log_warn(model_to_dict(instancia_modelo), level="debug")
+
+
+# Loggear una instancia Django (recomendado convertir a dict)
+from django.forms.models import model_to_dict
+_log_warn(model_to_dict(instancia_modelo), level="debug")
+
+# Usar extra para pasar metadata (si el handler/formatter lo soporta)
+user = ...  # instancia de usuario
+ot = ...    # alguna otra variable relevante
+_log_warn("Acceso a recurso", level="info", extra={"user_id": str(user.id), "ot": ot})
+
+# Nivel numérico
+_log_warn("Mensaje crítico numérico", level=50)  # equivale a CRITICAL
+
+'''

{eco_back-0.2.1.dist-info → eco_back-0.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eco-back
-Version: 0.2.1
+Version: 0.2.2
 Summary: Librería Python eco-back
 Author-email: EI UNP <ecosistema@unp.gov.co>
 License: MIT
@@ -38,18 +38,20 @@ Dynamic: license-file
 
 # eco-back
 
-Librería Python para backend con soporte para PostgreSQL/PostGIS y clientes API
+Librería Python para backend con soporte para PostgreSQL/PostGIS, clientes API, manejo de excepciones y logging
 
 ## Características
 
--  **Base de datos**: Conexión y operaciones con PostgreSQL
--  **PostGIS**: Operaciones geoespaciales (puntos, polígonos, búsquedas por proximidad)
--  **Cliente API**: Cliente HTTP genérico y cliente específico UNP
--  **Patrón Repository**: Implementación de patrones de diseño para acceso a datos
+- **Base de datos**: Conexión y operaciones con PostgreSQL
+- **PostGIS**: Operaciones geoespaciales (puntos, polígonos, búsquedas por proximidad)
+- **Cliente API**: Cliente HTTP genérico y cliente específico UNP
+- **Patrón Repository**: Implementación de patrones de diseño para acceso a datos
+- **Utils**: Sistema de excepciones y logging para Django
+- **Registro**: Funciones de trazabilidad para Django REST Framework
 
 ## Descripción
 
-eco-back es una librería modular que facilita el desarrollo de aplicaciones backend, proporcionando abstracciones para bases de datos geoespaciales y consumo de APIs REST.
+eco-back es una librería modular que facilita el desarrollo de aplicaciones backend, proporcionando abstracciones para bases de datos geoespaciales, consumo de APIs REST, manejo de excepciones y logging estructurado.
 
 ## Instalación
 
@@ -194,6 +196,58 @@ flake8 src/ tests/
 mypy src/
 ```
 
+### Manejo de excepciones y logging (Django)
+
+```python
+from eco_back.utils import (
+    ServiceValidationError,
+    handle_service_validation_error,
+    _log_warn
+)
+from rest_framework.decorators import api_view
+from rest_framework.response import Response
+
+@api_view(['GET'])
+@handle_service_validation_error
+def mi_vista(request, user_id):
+    try:
+        _log_warn(f"Buscando usuario {user_id}", level="info")
+        
+        usuario = Usuario.objects.get(id=user_id)
+        return Response({"usuario": usuario.username})
+        
+    except Usuario.DoesNotExist:
+        _log_warn(f"Usuario {user_id} no encontrado", level="warning")
+        raise ServiceValidationError(
+            "Usuario no encontrado",
+            code=404,
+            context={"user_id": user_id}
+        )
+```
+
+### Trazabilidad de registros (Django)
+
+```python
+from eco_back.registro import TrazabilidadRegistroPermiso
+from django.urls import path
+
+urlpatterns = [
+    path('api/trazabilidad/<int:registro_id>/', TrazabilidadRegistroPermiso),
+]
+```
+
+## Módulos disponibles
+
+- `eco_back.database` - Conexiones y operaciones con PostgreSQL/PostGIS
+- `eco_back.api` - Clientes HTTP y consumo de APIs
+- `eco_back.documento` - Manejo de documentos y anexos
+- `eco_back.utils` - Excepciones y logging para Django
+- `eco_back.registro` - Funciones de trazabilidad (Django REST Framework)
+
+Para más información, consulta los README de cada módulo:
+- [Utils (excepciones y logging)](src/eco_back/utils/README.md)
+- [Registro (trazabilidad)](src/eco_back/registro/README.md)
+
 ## Licencia
 
 MIT

{eco_back-0.2.1.dist-info → eco_back-0.2.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-eco_back/__init__.py,sha256=-RSbnbAjw4et97vl6xBoZkLlKL5gsOVn4t6iW-0zzEA,255
+eco_back/__init__.py,sha256=CZC7VjSE1Z_VIpywk8VNxKdD2QYZxMF4FcX6Ok2qKn8,285
 eco_back/api/__init__.py,sha256=9moiU5H8jGlva8k65bUK49LRIkE7bcLH1SK1dk23wcM,202
 eco_back/api/client.py,sha256=b2J9ty7mRtPUsMD-YJui60B9GEa-85VAAb-sS5y1Rp8,8537
 eco_back/api/config.py,sha256=dyERZY_4lXtRjhqLaHI0F4WlgPOQ_sw35eHNWGkQNLo,1590
@@ -12,9 +12,12 @@ eco_back/database/repository.py,sha256=NFh0pfvf7Pw878qOoVhR8ARMFC0CiJBQ_EwKshY8l
 eco_back/documento/__init__.py,sha256=0rIgJ52in_BMg7VYr2pVlu9EnTPftgdqJ4hOZU5I4j0,146
 eco_back/documento/anexos.py,sha256=KIzGNEVJ6tV3awhq4WGiqb8eSV2PluRRZ0PRbqeO5VE,17511
 eco_back/registro/__init__.py,sha256=CRDv6OSKzt1r-RnKSfv86Ceb7yfL2Fn-OhHGCx467lE,148
-eco_back/registro/trazabilidad.py,sha256=nj0DRCqSkJ57GVnw8kAYVpCxr1JZ1nb3n-zmTQ8QlBQ,1258
-eco_back-0.2.1.dist-info/licenses/LICENSE,sha256=XKKSDU9WlUEAyPNlRhq6e2xhVNpJc097JwPZJ1rUnRE,1077
-eco_back-0.2.1.dist-info/METADATA,sha256=9iudxyPMgsc09sle7BE_bisz3k9N1hzhRIHnzvBkwrw,4736
-eco_back-0.2.1.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-eco_back-0.2.1.dist-info/top_level.txt,sha256=ViJZv023782XNNFMcAsRC9iN1CU3tb8lP9wDAHacMyc,9
-eco_back-0.2.1.dist-info/RECORD,,
+eco_back/registro/trazabilidad.py,sha256=usjHeF7cY2cJGlOcJaTFCfQLAvOjXNAQsTQkb2GQM7I,1237
+eco_back/utils/__init__.py,sha256=DM0Y6fMeoRH6tG0skpkfEUVR71OAIFuVKQDC3_XBHvc,317
+eco_back/utils/exceptions.py,sha256=woKrhxkncGIG_rCgRFT6B9ZAgV2TdaCH4Vcusyj3aX4,2010
+eco_back/utils/logger_generico.py,sha256=1FIalQDkxzu0NBj-L7SzTuKEWcZuh25ZcIEux5WCB2c,4227
+eco_back-0.2.2.dist-info/licenses/LICENSE,sha256=XKKSDU9WlUEAyPNlRhq6e2xhVNpJc097JwPZJ1rUnRE,1077
+eco_back-0.2.2.dist-info/METADATA,sha256=1i4xVs7pPTO1sLaOmSxGAG92y8NqnAg-tYOtFHum674,6544
+eco_back-0.2.2.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+eco_back-0.2.2.dist-info/top_level.txt,sha256=ViJZv023782XNNFMcAsRC9iN1CU3tb8lP9wDAHacMyc,9
+eco_back-0.2.2.dist-info/RECORD,,