exzlogger

KO | EN

gitlite — search

#javascript #react #typescript #golang #rust #linux #nodejs #java #awesome #cli #awesome-list #pytorch #security #ios

(★ 17)

Easily create useful logger.

exzlogger Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ExzLogger: A High-Performance, Zero-Config Python Logging Wrapper

[![PyPI version](https://img.shields.io/pypi/v/exzlogger.svg)](https://pypi.org/project/exzlogger/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/exzlogger.svg)](https://pypi.org/project/exzlogger/)
[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

**Get production-ready logs in one line of code. Stop fighting with boilerplate `logging` configurations.**

---

## 🌟 Why ExzLogger?

`ExzLogger` is a minimalist logging utility designed for developers who need reliable, industry-standard logging without the setup headache.

* **Zero Configuration:** Start logging immediately with sensible defaults.
* **Built for Production:** Out-of-the-box support for daily log rotation and color-coded console output.
* **Research-Hardened:** Developed for AI research and industrial monitoring where data integrity and error traceability are non-negotiable.

---

## 📦 Installation

```bash
pip install exzlogger
```

### 🛠 Usage & Features

#### 1. Quick Start (Basic Logging)
Simply import and use. By default, logs are mirrored to both the console and a daily rotating file in `./logs/`.

```python
from exzlogger import logger

logger.info("ExzLogger is ready for production!")
logger.error("A critical error occurred in the data pipeline.")
```

#### 2. Advanced: The @magic_exception Decorator
Handling function-level exceptions with `try-except` blocks can clutter your code. Use `@magic_exception` to handle errors gracefully with high visibility.

- Context-Aware: Automatically captures function arguments in the log message.
- Safe Recovery: Define a default return value (except_return) to prevent program crashes.

Parameters:
- `logger` <logging.Logger>: The logger instance to log the exception messages, use logger provide above to get best of them!
- `msg_format` <str>: The format of the message to be logged.
- `except_return` <any>: The value to be returned if the decorated function fails.

```python
from exzlogger import logger, magic_exception

# Example: Return None if division fails, and log the specific input 'a'
@magic_exception(logger, "Calculation failed with input a={a}", except_return=None)
def process_data(a):
    return a / 0

result = process_data(10)
# Log Output: [process_data]: Calculation failed with input a=10 + Stack Trace
# Result: None
```

#### 3. Log Directory Structure
ExzLogger keeps your project clean by organizing logs by date automatically:
```Plaintext
your_project/
├── logs/
│   ├── 2026-01-27.log
│   └── 2026-01-28.log
└── main.py
```

exzlogger

exzlogger Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

exzlogger

exzlogger Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README