fastlog-io 0.1.7

loguru fast wrapping supports fastapi

FastLOG is a lightweight wrapper around Loguru that offers Prometheus metrics, automatic `trace_id`, colourful output, and a dead‑simple configuration API.

---

✨ Features

• Zero‑config out of the box – from fastlog-io import log; log.info("hello") works instantly.
• Unified interface – configure() + get_log(name) keep formatting consistent across modules.
• Automatic trace_id – generates a 7‑char NanoID when none is bound, perfect for request tracing.
• File rotation & retention – default rotation="100 MB"; tune it via configure().
• Stdlib compatibility – built‑in reset_std_logging() redirects the logging module to fastlog-io.

---

🚀 Installation

pip install fastlog-io

Requirements

• Python ≥ 3.12
• loguru

---

⚡ Quickstart

from fastlog import log, configure

# override defaults if needed
configure(level="DEBUG", log_dir="./logs")

log.info("service started")

# child logger
api_log = log.bind(name="api")
api_log.debug("new request")

Console output (colours stripped):

2025-06-21 09:57:56.510 | INFO     | app   | -cFZrY2V | main.<module>:7 | service started
2025-06-21 09:57:56.511 | DEBUG    | api   | -25bJVku | main.<module>:11 | new request

---

🔧 Environment variables

Variable	Default	Description
LOG_DIR	(empty)	Log file directory; leave blank to log to stderr only
LOG_LEVEL	INFO	Minimum log level
LOG_ROTATION	100 MB	File rotation policy (Loguru syntax)

These can also be passed directly to configure() and override environment values.

---

🛠 Development & Tests (powered by uv)

# run tests in a temp venv with test extras installed
uv run --with '.[test]' pytest -q

# build wheel + sdist
uv build

# verify the built wheel in a clean env
uv run --with dist/*.whl --with pytest pytest -q

---

📄 License

MIT © 2025 OWQ