Repolode
Enviar
Delgan

Delgan/loguru

Biblioteca de logging para Python que sustituye la configuración estándar por un único logger, rotación de archivos, salida en color y logs estructurados.

Ver en GitHubSitio web
Estrellas
24,153
Forks
828
Issues abiertos
261
Último commit
hace 6 días

¿Qué es?

Loguru es una biblioteca de logging para Python que busca eliminar el código repetitivo del módulo estándar de logging. Ofrece un logger preconfigurado que escribe en stderr desde el inicio, para que puedas empezar a registrar mensajes con un solo import. Los sinks, formatos, filtros y niveles adicionales se configuran mediante una única función add().

El logging en archivos incluye rotación por tamaño, tiempo o antigüedad, limpieza de archivos antiguos y compresión al cerrar. La biblioteca también ofrece formato de cadenas con llaves, salida en color, trazas de excepciones que incluyen los valores de las variables, y sinks seguros para hilos y para procesos múltiples mediante colas. Puedes adjuntar contexto con bind() o contextualize(), y serializar los mensajes a JSON.

Loguru incluye utilidades de compatibilidad con el módulo estándar de logging, que permiten dirigir objetos logging.Handler existentes a los sinks de Loguru o reenviar mensajes de Loguru al módulo estándar. Es compatible con Python 3.5 y versiones posteriores, así como con PyPy.

Funciones clave

  • 01Logger preconfigurado que funciona sin código de configuración
  • 02Una única función add() para gestionar sinks, formatos, filtros y niveles
  • 03Opciones de rotación, retención y compresión de archivos
  • 04Salida de terminal en color y trazas completas de excepciones con valores de variables
  • 05Sinks seguros para hilos y logging seguro para procesos múltiples mediante colas
  • 06Puentes de entrada y salida con el módulo estándar de logging de Python

Casos de uso

  • Añadir logging a un script de Python sin escribir la configuración del logger
  • Escribir archivos de log rotados y comprimidos para servicios de larga duración
  • Capturar excepciones generadas en hilos para que aparezcan en los logs
  • Mantener una biblioteca de Python en silencio de forma predeterminada y permitir que las aplicaciones activen sus logs

Inicio rápido

  1. 1

    Instala loguru desde PyPI

    pip install loguru
  2. 2

    Importa el logger listo para usar y registra un mensaje

En colecciones

Plataformas de OpenTelemetry y observabilidad

Temas

#logging#python#logger#log-rotation#structured-logging#debugging#log

Preguntas frecuentes

¿Qué es loguru?
Biblioteca de logging para Python que sustituye la configuración estándar por un único logger, rotación de archivos, salida en color y logs estructurados. Loguru es una biblioteca de logging para Python que busca eliminar el código repetitivo del módulo estándar de logging. Ofrece un logger preconfigurado que escribe en stderr desde el inicio, para que puedas empezar a registrar mensajes con un solo import. Los sinks, formatos, filtros y niveles adicionales se configuran mediante una única función add().
¿loguru es gratuito? ¿Qué licencia tiene?
loguru es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿loguru sigue mantenido?
Mantenimiento activo. El último commit de loguru fue el 18 oct 2026.
¿Para qué puedo usar loguru?
Añadir logging a un script de Python sin escribir la configuración del logger Escribir archivos de log rotados y comprimidos para servicios de larga duración Capturar excepciones generadas en hilos para que aparezcan en los logs Mantener una biblioteca de Python en silencio de forma predeterminada y permitir que las aplicaciones activen sus logs
¿Cómo se instala loguru?
Instala loguru desde PyPI: pip install loguru Importa el logger listo para usar y registra un mensaje
¿Dónde consigo loguru?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Delgan/loguru

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados