Ezplog¶

ezplog is a modern Python logging framework combining Rich console rendering and loguru file logging with an explicit app/lib compatibility model.

🚀 Quick start¶

pipuv

pip install ezplog

uv add ezplog

from ezplog import Ezpl

ezpl = Ezpl(log_file="app.log", hook_logger=True)  # (1)!
ezpl.info("Application started")
ezpl.get_printer().success("Ready")  # (2)!

Enables stdlib logger interception for consistent app and library pipelines.
Uses Rich console rendering while the file logger writes to disk.

✨ Key features¶

Unified singleton API for console and file logging.
Rich output patterns, JSON, tables, panels, and progress tools.
Loguru file sink with rotation, retention, and compression.
Explicit compatibility hooks between app mode and lib mode.
Configuration priority: arguments, environment, file, defaults.

📚 Documentation¶

Section	Description
Getting Started	Tutorial for a working setup in a few minutes.
User Guides	Task-focused configuration and operational recipes.
Concepts	Architecture rationale and mode interactions.
API Reference	Curated API map and auto-generated technical reference.
CLI Reference	Command and option reference for the CLI.
Examples	Copy-paste runnable scenarios.

📋 Requirements¶

Python >= 3.11
rich >= 13.0.0
loguru >= 0.7.2
click >= 8.0.0

⚖️ License¶

MIT. See LICENSE.