logger-tracker 0.1.0__tar.gz

logger_tracker-0.1.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.3
+Name: logger-tracker
+Version: 0.1.0
+Summary: Libreria estandar para manejo de logs estandar
+Author: damian27goa@gmail.com
+Requires-Python: >=3.13,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: pytest
+Requires-Dist: rich
+Description-Content-Type: text/markdown
+
+# Logger Tracker
+
+Una librería de logging estandarizada para Python que proporciona trazabilidad mediante UUIDs únicos por hilo de ejecución, con soporte para salida enriquecida en consola.
+
+## Descripción
+
+Logger Tracker es un módulo de logging diseñado para entornos concurrentes y aplicaciones web. Proporciona:
+
+- **UUIDs únicos por hilo**: Cada log incluye un identificador único para trazabilidad en entornos multi-hilo
+- **Salida enriquecida**: Usa Rich para tracebacks y formateo mejorado en consola
+- **Configuración automática**: Se configura al importar el módulo
+- **API simple**: Funciones de logging estandarizadas con acceso directo
+- **Integración con frameworks**: Soporte nativo para Flask/Werkzeug
+
+## Instalación
+
+Instala desde PyPI:
+
+```bash
+pip install logguer-tracker
+```
+
+O desde el código fuente:
+
+```bash
+git clone https://github.com/tu-usuario/logguer-tracker.git
+cd logguer-tracker
+pip install -e .
+```
+
+## Uso Básico
+
+### Importación y configuración automática
+
+Simplemente importa el módulo para configurar el logging automáticamente:
+
+```python
+import logger_tracker
+
+# El logging ya está configurado con UUIDs y Rich handler
+```
+
+### Uso de la API principal
+
+```python
+from logger_tracker import get_logger
+
+# Obtener un logger con funciones de logging
+logger = get_logger("mi_modulo")
+
+logger["info"]("Mensaje informativo")
+logger["debug"]("Mensaje de debug")
+logger["warning"]("Mensaje de advertencia")
+logger["error"]("Mensaje de error")
+logger["critical"]("Mensaje crítico")
+```
+
+### Uso de funciones legacy
+
+Para compatibilidad con código existente:
+
+```python
+from logger_tracker import logg_info, logg_debug, logg_warning, logg_error, logg_critical
+
+logg_info("Mensaje informativo")
+logg_debug("Mensaje de debug")
+logg_warning("Mensaje de advertencia")
+logg_error("Mensaje de error")
+logg_critical("Mensaje crítico")
+```
+
+## Características
+
+- **Thread-safe**: UUIDs únicos por hilo de ejecución
+- **Trazabilidad**: Cada log incluye un UUID para seguimiento
+- **Salida enriquecida**: Tracebacks coloreados y formateados con Rich
+- **Configuración automática**: No requiere configuración manual
+- **Integración con Flask**: Soporte automático para logging de Werkzeug
+- **API flexible**: Tanto dict-based como funciones directas
+
+## API
+
+### Funciones principales
+
+- `setup_logging()`: Configura el sistema de logging (llamado automáticamente al importar)
+- `get_logger(name: str) -> dict`: Devuelve un diccionario con funciones de logging
+- `attach_logger_to_werkzeug()`: Integra el logging con Flask/Werkzeug
+
+### Funciones legacy
+
+- `logg_info(message)`
+- `logg_debug(message)`
+- `logg_warning(message)`
+- `logg_error(message)`
+- `logg_critical(message)`
+
+## Ejemplos
+
+### En una aplicación Flask
+
+```python
+from flask import Flask
+from logger_tracker import get_logger, attach_logger_to_werkzeug
+
+app = Flask(__name__)
+
+# Configurar logging para Flask
+attach_logger_to_werkzeug()
+
+logger = get_logger("flask_app")
+
+@app.route('/')
+def hello():
+    logger["info"]("Solicitud a la ruta principal")
+    return "Hello World!"
+
+if __name__ == '__main__':
+    app.run()
+```
+
+### En un script multi-hilo
+
+```python
+import threading
+import time
+from logger_tracker import get_logger
+
+def worker(worker_id):
+    logger = get_logger(f"worker_{worker_id}")
+    logger["info"](f"Trabajador {worker_id} iniciado")
+    time.sleep(1)
+    logger["info"](f"Trabajador {worker_id} finalizado")
+
+# Crear múltiples hilos
+threads = []
+for i in range(3):
+    t = threading.Thread(target=worker, args=(i,))
+    threads.append(t)
+    t.start()
+
+for t in threads:
+    t.join()
+```
+
+Cada hilo tendrá su propio UUID en los logs, permitiendo trazabilidad completa.
+
+## Formato de salida
+
+Los logs se muestran en el formato:
+
+```
+[UUID] Mensaje
+```
+
+Ejemplo:
+
+```
+[550e8400-e29b-41d4-a716-446655440000] Aplicación iniciada
+[550e8400-e29b-41d4-a716-446655440000] Procesando solicitud
+[6ba7b810-9dad-11d1-80b4-00c04fd430c8] Nuevo hilo iniciado
+```
+
+## Requisitos
+
+- Python >= 3.13
+- rich
+- pytest (para tests)
+
+## Licencia
+
+Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
+
+## Contribución
+
+Para contribuir:
+
+1. Fork el repositorio
+2. Crea una rama para tu feature
+3. Ejecuta los tests: `pytest`
+4. Envía un pull request
+
+## Soporte
+
+Para reportar bugs o solicitar features, usa los issues de GitHub.
+

logger_tracker-0.1.0/README.md

@@ -0,0 +1,184 @@
+# Logger Tracker
+
+Una librería de logging estandarizada para Python que proporciona trazabilidad mediante UUIDs únicos por hilo de ejecución, con soporte para salida enriquecida en consola.
+
+## Descripción
+
+Logger Tracker es un módulo de logging diseñado para entornos concurrentes y aplicaciones web. Proporciona:
+
+- **UUIDs únicos por hilo**: Cada log incluye un identificador único para trazabilidad en entornos multi-hilo
+- **Salida enriquecida**: Usa Rich para tracebacks y formateo mejorado en consola
+- **Configuración automática**: Se configura al importar el módulo
+- **API simple**: Funciones de logging estandarizadas con acceso directo
+- **Integración con frameworks**: Soporte nativo para Flask/Werkzeug
+
+## Instalación
+
+Instala desde PyPI:
+
+```bash
+pip install logguer-tracker
+```
+
+O desde el código fuente:
+
+```bash
+git clone https://github.com/tu-usuario/logguer-tracker.git
+cd logguer-tracker
+pip install -e .
+```
+
+## Uso Básico
+
+### Importación y configuración automática
+
+Simplemente importa el módulo para configurar el logging automáticamente:
+
+```python
+import logger_tracker
+
+# El logging ya está configurado con UUIDs y Rich handler
+```
+
+### Uso de la API principal
+
+```python
+from logger_tracker import get_logger
+
+# Obtener un logger con funciones de logging
+logger = get_logger("mi_modulo")
+
+logger["info"]("Mensaje informativo")
+logger["debug"]("Mensaje de debug")
+logger["warning"]("Mensaje de advertencia")
+logger["error"]("Mensaje de error")
+logger["critical"]("Mensaje crítico")
+```
+
+### Uso de funciones legacy
+
+Para compatibilidad con código existente:
+
+```python
+from logger_tracker import logg_info, logg_debug, logg_warning, logg_error, logg_critical
+
+logg_info("Mensaje informativo")
+logg_debug("Mensaje de debug")
+logg_warning("Mensaje de advertencia")
+logg_error("Mensaje de error")
+logg_critical("Mensaje crítico")
+```
+
+## Características
+
+- **Thread-safe**: UUIDs únicos por hilo de ejecución
+- **Trazabilidad**: Cada log incluye un UUID para seguimiento
+- **Salida enriquecida**: Tracebacks coloreados y formateados con Rich
+- **Configuración automática**: No requiere configuración manual
+- **Integración con Flask**: Soporte automático para logging de Werkzeug
+- **API flexible**: Tanto dict-based como funciones directas
+
+## API
+
+### Funciones principales
+
+- `setup_logging()`: Configura el sistema de logging (llamado automáticamente al importar)
+- `get_logger(name: str) -> dict`: Devuelve un diccionario con funciones de logging
+- `attach_logger_to_werkzeug()`: Integra el logging con Flask/Werkzeug
+
+### Funciones legacy
+
+- `logg_info(message)`
+- `logg_debug(message)`
+- `logg_warning(message)`
+- `logg_error(message)`
+- `logg_critical(message)`
+
+## Ejemplos
+
+### En una aplicación Flask
+
+```python
+from flask import Flask
+from logger_tracker import get_logger, attach_logger_to_werkzeug
+
+app = Flask(__name__)
+
+# Configurar logging para Flask
+attach_logger_to_werkzeug()
+
+logger = get_logger("flask_app")
+
+@app.route('/')
+def hello():
+    logger["info"]("Solicitud a la ruta principal")
+    return "Hello World!"
+
+if __name__ == '__main__':
+    app.run()
+```
+
+### En un script multi-hilo
+
+```python
+import threading
+import time
+from logger_tracker import get_logger
+
+def worker(worker_id):
+    logger = get_logger(f"worker_{worker_id}")
+    logger["info"](f"Trabajador {worker_id} iniciado")
+    time.sleep(1)
+    logger["info"](f"Trabajador {worker_id} finalizado")
+
+# Crear múltiples hilos
+threads = []
+for i in range(3):
+    t = threading.Thread(target=worker, args=(i,))
+    threads.append(t)
+    t.start()
+
+for t in threads:
+    t.join()
+```
+
+Cada hilo tendrá su propio UUID en los logs, permitiendo trazabilidad completa.
+
+## Formato de salida
+
+Los logs se muestran en el formato:
+
+```
+[UUID] Mensaje
+```
+
+Ejemplo:
+
+```
+[550e8400-e29b-41d4-a716-446655440000] Aplicación iniciada
+[550e8400-e29b-41d4-a716-446655440000] Procesando solicitud
+[6ba7b810-9dad-11d1-80b4-00c04fd430c8] Nuevo hilo iniciado
+```
+
+## Requisitos
+
+- Python >= 3.13
+- rich
+- pytest (para tests)
+
+## Licencia
+
+Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.
+
+## Contribución
+
+Para contribuir:
+
+1. Fork el repositorio
+2. Crea una rama para tu feature
+3. Ejecuta los tests: `pytest`
+4. Envía un pull request
+
+## Soporte
+
+Para reportar bugs o solicitar features, usa los issues de GitHub.

logger_tracker-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[tool.poetry]
+name = "logger-tracker"
+version = "0.1.0"
+description = "Libreria estandar para manejo de logs estandar"
+authors = ["damian27goa@gmail.com"]
+readme = "README.md"
+packages = [
+    { include = "logger_tracker", from = "src" }
+]
+
+[tool.poetry.dependencies]
+python = "^3.13"
+rich = "*"
+pytest = "*"
+
+[tool.poetry.group.dev.dependencies]
+# Dependencias de desarrollo aquí si las tienes
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

logger_tracker-0.1.0/src/logger_tracker/__init__.py

@@ -0,0 +1,132 @@
+# -------------------------
+# Copyright (c) 2026 Erick Damian Gonzalez Aranda
+#
+# Este software y su código fuente han sido desarrollados por Erick Damian Gonzalez Aranda, mediante 
+# NeuronexoTec Organizacion de desarrollo de Software.
+# Todos los derechos están reservados.
+#
+# Se permite el uso, copia y modificación del código únicamente para fines
+# personales, educativos o internos, siempre que se conserve este aviso
+# de copyright y no se redistribuya el software, total o parcialmente,
+# sin autorización expresa del autor.
+#
+# Queda estrictamente prohibida la venta, sublicencia, redistribución,
+# exposición como servicio (SaaS), o incorporación en productos comerciales
+# sin consentimiento previo y por escrito del autor.
+#
+# Este software se proporciona "tal cual", sin garantía de ningún tipo,
+# expresa o implícita, incluyendo pero no limitado a garantías de
+# comercialización, idoneidad para un propósito particular o ausencia
+# de defectos.
+# 
+# El autor no será responsable por ningún daño directo o indirecto
+# derivado del uso de este software.
+# -------------------------
+
+import logging
+import threading
+import uuid
+from typing import Callable
+
+from rich.logging import RichHandler
+
+
+# -------------------------
+# Almacenamiento thread-local
+# Responsabilidad:
+# Mantener un UUID único por hilo de ejecución
+# para trazabilidad de logs en entornos concurrentes
+# -------------------------
+_request_uuid = threading.local()
+
+
+# -------------------------
+# Filtro de logging con UUID
+# Responsabilidad:
+# Inyectar un UUID por request/hilo
+# en cada registro de log
+#
+# Uso:
+# Se asocia a handlers de logging
+# -------------------------
+class UUIDLogFilter(logging.Filter):
+
+    def filter(self, record: logging.LogRecord) -> bool:
+        if not hasattr(_request_uuid, "id"):
+            _request_uuid.id = str(uuid.uuid4())
+
+        record.uuid = _request_uuid.id
+        return True
+
+
+# -------------------------
+# Configuración del sistema de logging
+# Responsabilidad:
+# Inicializar logging global con:
+# - UUID por request
+# - RichHandler para salida en consola
+# - Formato uniforme
+#
+# Side effects:
+# - Configura logging root
+# - Expone funciones de logging de uso rápido
+# -------------------------
+def setup_logging() -> None:
+    uuid_filter = UUIDLogFilter()
+
+    handler = RichHandler(
+        rich_tracebacks=True,
+        tracebacks_suppress=[logging]
+    )
+    handler.addFilter(uuid_filter)
+
+    logging.basicConfig(
+        level=logging.DEBUG,
+        format="[%(uuid)s] %(message)s",
+        datefmt="[%X]",
+        handlers=[handler]
+    )
+
+
+# -------------------------
+# API pública de logging
+# Responsabilidad:
+# Proveer accesos directos a niveles
+# de logging estandarizados
+# -------------------------
+def get_logger(name: str = __name__) -> dict[str, Callable]:
+    logger = logging.getLogger(name)
+    return {
+        "info": logger.info,
+        "debug": logger.debug,
+        "warning": logger.warning,
+        "error": logger.error,
+        "critical": logger.critical,
+    }
+
+def attach_logger_to_werkzeug():
+    werkzeug_logger = logging.getLogger("werkzeug")
+    app_logger = logging.getLogger("app")
+
+    werkzeug_logger.handlers = app_logger.handlers
+    werkzeug_logger.setLevel(logging.INFO)
+    werkzeug_logger.propagate = False
+
+# -------------------------
+# API LEGACY (compatibilidad)
+# Responsabilidad:
+# Mantener compatibilidad con imports existentes:
+#   logger.logg_info(...)
+# -------------------------
+_logger = logging.getLogger("app")
+
+logg_info = _logger.info
+logg_debug = _logger.debug
+logg_warning = _logger.warning
+logg_error = _logger.error
+logg_critical = _logger.critical
+
+# -------------------------
+# Bootstrap automático del logging
+# -------------------------
+setup_logging()