Metadata-Version: 2.3
Name: jaylog
Version: 0.3.3
Summary: Customized Python logging library with file rotation and HTTP forwarding
Author: Gpocas
Author-email: Gpocas <gpocas01@gmail.com>
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Development Status :: 5 - Production/Stable
Requires-Dist: pydantic>=2.0,<3.0
Requires-Dist: pydantic-settings>=2.0,<3.0
Requires-Dist: requests>=2.32,<3.0
Requires-Dist: pillow>=11.0,<13.0
Requires-Dist: psutil>=5.9.6,<8
Requires-Python: >=3.10, <3.14
Project-URL: repository, https://github.com/Gpocas/jaylog
Project-URL: Bug Tracker, https://github.com/Gpocas/jaylog/issues
Description-Content-Type: text/markdown

# jaylog

Biblioteca de logging para Python com rotação de arquivos, saída colorida no console, envio HTTP para um endpoint remoto e registro automático do ambiente de execução (host reporting).

📖 **Documentação completa:** https://gpocas.github.io/jaylog-book

## Instalação

```bash
pip install -U --no-cache-dir jaylog
```

## Uso rápido

__*.env.logging*__
```env
JAYLOG_APP_NAME=meu-bot
JAYLOG_LOG_DIR=C:\logs
```

__*main.py*__
```python
from jaylog import JaylogSettings, configure, get_logger

configure(JaylogSettings())

logger = get_logger()

logger.info("Olá, jaylog!")
```

## Certificado TLS (HTTPS)

`JAYLOG_LOG_HTTP_VERIFY` controla a verificação do certificado em todos os envios HTTP (logs, host, métricas, heartbeat e agendas):

| Valor | Efeito |
|---|---|
| `true` (`1`, `yes`, `on`) | Verifica com o bundle padrão do `requests` (`certifi`, ou `REQUESTS_CA_BUNDLE` se definida) |
| `/caminho/corp-ca.pem` | Verifica com esse CA bundle — use para proxy corporativo com inspeção TLS. O caminho precisa existir: senão `JaylogSettings()` falha na inicialização |
| `false` (`0`, `no`, `off`) | Não verifica (inseguro); o jaylog avisa no stderr |

> **0.3.x:** o padrão ainda é `false` por compatibilidade e passa a ser `true` na **0.4.0**. Para antecipar, defina `JAYLOG_LOG_HTTP_VERIFY=true` ou o caminho do bundle corporativo.
