Repolode
Enviar
Delgan

Delgan/loguru

Biblioteca de logging para Python que substitui a configuração padrão por um único logger, rotação de arquivos, saída colorida e logs estruturados.

Ver no GitHubSite
Estrelas
24,153
Forks
828
Issues abertas
261
Último commit
há 6 dias

O que é?

Loguru é uma biblioteca de logging para Python criada para eliminar o código repetitivo do módulo padrão de logging. Ela oferece um logger pré-configurado que escreve em stderr por padrão, para você começar a registrar mensagens com um único import. Sinks, formatos, filtros e níveis adicionais são configurados com uma única função add().

O logging em arquivos inclui rotação por tamanho, tempo ou idade, limpeza por retenção e compactação ao fechar. A biblioteca também oferece formatação de strings no estilo de chaves, saída colorida, stack traces de exceções que incluem os valores das variáveis e sinks seguros para threads e para multiprocessamento com filas. É possível associar contexto com bind() ou contextualize(), e serializar mensagens em JSON.

Loguru inclui auxiliares de compatibilidade com o módulo padrão de logging, que permitem direcionar objetos logging.Handler existentes para sinks do Loguru ou encaminhar mensagens do Loguru de volta ao módulo padrão. É compatível com Python 3.5 ou posterior e também com PyPy.

Recursos principais

  • 01Logger pré-configurado que funciona sem código de configuração
  • 02Uma única função add() para gerenciar sinks, formatos, filtros e níveis
  • 03Opções de rotação, retenção e compactação de arquivos
  • 04Saída colorida no terminal e stack traces completos de exceções com valores das variáveis
  • 05Sinks seguros para threads e logging seguro para multiprocessamento baseado em filas
  • 06Integração de entrada e saída com o módulo padrão de logging do Python

Casos de uso

  • Adicionar logging a um script Python sem escrever configurações do logger
  • Gravar arquivos de log com rotação e compactação para serviços de longa duração
  • Capturar exceções lançadas em threads para que apareçam nos logs
  • Manter uma biblioteca Python silenciosa por padrão e permitir que as aplicações ativem seus logs

Início rápido

  1. 1

    Instale loguru do PyPI

    pip install loguru
  2. 2

    Importe o logger pronto para uso e registre uma mensagem

Em coleções

Plataformas de OpenTelemetry e observabilidade

Tópicos

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

Perguntas frequentes

O que é loguru?
Biblioteca de logging para Python que substitui a configuração padrão por um único logger, rotação de arquivos, saída colorida e logs estruturados. Loguru é uma biblioteca de logging para Python criada para eliminar o código repetitivo do módulo padrão de logging. Ela oferece um logger pré-configurado que escreve em stderr por padrão, para você começar a registrar mensagens com um único import. Sinks, formatos, filtros e níveis adicionais são configurados com uma única função add().
loguru é gratuito? Qual é a licença?
loguru é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
loguru ainda é mantido?
Manutenção ativa. O último commit de loguru foi em 18 de out. de 2026.
Para que posso usar loguru?
Adicionar logging a um script Python sem escrever configurações do logger Gravar arquivos de log com rotação e compactação para serviços de longa duração Capturar exceções lançadas em threads para que apareçam nos logs Manter uma biblioteca Python silenciosa por padrão e permitir que as aplicações ativem seus logs
Como instalar loguru?
Instale loguru do PyPI: pip install loguru Importe o logger pronto para uso e registre uma mensagem
Onde consigo loguru?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Delgan/loguru

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados