Avaliar viabilidade e estratégia para integração de logging

[niltonpimentel02]

Seu pedido de recurso está relacionado a um problema?

• A ausência de um sistema de logging no projeto dificulta a análise de comportamento em tempo de execução, a identificação de gargalos e a depuração de problemas, especialmente em ambientes de produção ou quando o código é executado por terceiros.

---

Descreva a solução que você gostaria

• Realizar um estudo de viabilidade para a implementação da biblioteca padrão logging do Python. Isso incluiria analisar o impacto no tamanho do pacote, na performance, na complexidade de configuração para usuários e desenvolvedores, e na compatibilidade com as ferramentas de monitoramento existentes (se houver). O objetivo é determinar a melhor estratégia para integrar logging de forma leve e eficaz.

---

Descreva alternativas que você considerou

• Manter o status quo (sem logging): não resolve os problemas de observabilidade e depuração.
• Usar bibliotecas de logging de terceiros: pode adicionar dependências desnecessárias e aumentar o tamanho do pacote, o que vai contra a filosofia de utilitários leves.

---

Contexto adicional

• Pontos a serem investigados no estudo:
  • Overhead de performance da biblioteca logging.
  • Facilidade de configuração para diferentes níveis de detalhe (DEBUG, INFO, WARNING, ERROR).
  • Opções de saída (console, arquivo, etc.) e como torná-las configuráveis.
  • Impacto na experiência do desenvolvedor ao adicionar chamadas de log.
  • Como evitar logs excessivos que possam poluir a saída ou gerar arquivos grandes.
• Benefícios esperados: melhor compreensão do comportamento da biblioteca, facilitação da depuração e maior robustez em cenários de uso diversos.

---

💌 Quer contribuir, mas não se sente à vontade?

Você tem vontade de contribuir, mas não se sente à vontade em abrir issues, PRs ou fazer perguntas publicamente?

Nós sabemos como pode ser difícil dar o primeiro passo em um espaço aberto. A insegurança, o medo de errar ou até a sensação de “será que minha dúvida é boba?” podem pesar bastante. E tá tudo bem sentir isso. 💜

Queremos que você saiba que aqui ninguém precisa enfrentar esse caminho sem apoio. Se preferir um espaço mais reservado, você pode mandar um e-mail para [email protected] e teremos o maior prazer em ajudar. Seja para tirar dúvidas, pedir orientação ou simplesmente ter alguém para conversar sobre como começar.

O importante é que você saiba: sua participação é muito bem-vinda, e cada contribuição, por menor que pareça, faz uma grande diferença. ✨

[antoniamaia]

bora!

[github-actions[bot]]

🇧🇷 Português ✅ Issue #628 atribuída a @antoniamaia. Verifique o guia de contribuição para instruções sobre como submeter sua Pull Request.

🇬🇧 English ✅ Issue #628 assigned to @antoniamaia. Check the contributing guide for instructions on submitting your Pull Request.