eco-back 0.2.0__tar.gz → 0.2.2__tar.gz

{eco_back-0.2.0/src/eco_back.egg-info → eco_back-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eco-back
-Version: 0.2.0
+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.0 → eco_back-0.2.2}/README.md

@@ -1,17 +1,19 @@
 # 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
 
@@ -156,6 +158,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.0 → eco_back-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "eco-back"
-version = "0.2.0"
+version = "0.2.2"
 description = "Librería Python eco-back"
 readme = "README.md"
 requires-python = ">=3.8"

{eco_back-0.2.0 → eco_back-0.2.2}/src/eco_back/__init__.py

@@ -2,12 +2,13 @@
 eco-back - Librería Python
 """
 
-__version__ = "0.2.0"
+__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-0.2.0 → eco_back-0.2.2}/src/eco_back/api/registro.py

@@ -89,3 +89,6 @@ class Consecutivo:
         """Context manager exit"""
         self.close()
         return False
+
+
+

eco_back-0.2.2/src/eco_back/registro/trazabilidad.py

@@ -0,0 +1,27 @@
+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
+from rest_framework import status
+from registro.models.models_global import Trazabilidad
+from registro.serializer.serializer_get import TrazabilidadSerializer
+from rest_framework.response import Response
+ 
+ 
+ 
+@csrf_exempt
+@api_view(['GET'])
+@renderer_classes([JSONRenderer])
+@handle_service_validation_error
+def TrazabilidadRegistroPermiso(request, registro_id):
+    try:
+        trazabilidades = Trazabilidad.objects.filter(
+            registro=int(registro_id)
+        ).order_by('fecha_recibido')
+ 
+        serializer = TrazabilidadSerializer(trazabilidades, many=True)
+        return Response(serializer.data, status=status.HTTP_200_OK)
+    except Exception as e:
+        _log_warn(f"Consulta trazabilidades - error consultando trazabilidades: {e}", level='error', exc_info=True)
+        raise ServiceValidationError("Trazabilidades no encontradas", code=400, context={"exception": str(e)})

eco_back-0.2.2/src/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-0.2.2/src/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-0.2.2/src/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.0 → eco_back-0.2.2/src/eco_back.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: eco-back
-Version: 0.2.0
+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.0 → eco_back-0.2.2}/src/eco_back.egg-info/SOURCES.txt

@@ -22,6 +22,9 @@ src/eco_back/documento/__init__.py
 src/eco_back/documento/anexos.py
 src/eco_back/registro/__init__.py
 src/eco_back/registro/trazabilidad.py
+src/eco_back/utils/__init__.py
+src/eco_back/utils/exceptions.py
+src/eco_back/utils/logger_generico.py
 tests/test_anexos.py
 tests/test_api.py
 tests/test_database.py