Primeiros Passos¶
Important
configure() deve ser chamado antes de usar o logger. get_logger() pode ser chamado antes — ele devolve um proxy preguiçoso (_LazyLogger) e só levanta uma exceção no primeiro uso efetivo (logger.info(...), etc.), caso configure() ainda não tenha rodado até lá. Isso permite fazer logger = get_logger() no topo de um módulo antes de configure() ter rodado em outro lugar.
O fluxo básico de uso do jaylog é sempre o mesmo:
- Criar uma instância de
JaylogSettings(as configurações podem vir de variáveis de ambiente, de um arquivo.env, ou serem passadas diretamente no construtor). - Chamar
configure()com essas configurações. - Obter o logger com
get_logger()e usá-lo normalmente.
Exemplo¶
.env.logging
main.py
from jaylog import JaylogSettings, configure, get_logger
configure(JaylogSettings())
logger = get_logger()
logger.info("Meu primeiro log")
Por padrão, o jaylog carrega automaticamente o arquivo .env.logging da raiz do projeto. As variáveis usam o prefixo JAYLOG_ — a lista completa está em Variáveis de Ambiente.
Apenas JAYLOG_APP_NAME é obrigatório: ele nomeia o serviço/bot e dá nome ao arquivo de log. Se JAYLOG_LOG_DIR não for definido, o jaylog registra apenas no console.
Próximo passo¶
Veja a lista completa de Variáveis de Ambiente disponíveis.