Metadata-Version: 2.4
Name: kiwilog
Version: 0.2.1
Summary: A beautiful, configurable colored logging utility for Python
Author: cCocoa
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Dynamic: requires-python

<div align="center">

# 🥝 KiwiLog

### A **beautiful, colorful logging utility** for Python

![Python](https://img.shields.io/badge/Python-3.x-blue?style=for-the-badge&logo=python)
![Status](https://img.shields.io/badge/status-active-success?style=for-the-badge)
![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)

Elegant • Minimal • Readable • Colorful

</div>

---

# Overview

**KiwiLog** is a lightweight Python logging utility designed to make terminal output **clean, colorful, and easy to read**.

Instead of dealing with complex logging frameworks, KiwiLog provides **simple functions** for common log types.

Perfect for:

- CLI tools  
- Scripts  
- Debugging  
- Automation  
- Bots  
- Development utilities  

---

# Available Commands / How to Use

KiwiLog provides simple, color-coded logging functions:

| Command | Description | Example |
|---------|------------|---------|
| `trace(msg)` | Very low-level tracing | `kiwilog.trace("Step 1 check")` |
| `debug(msg)` | Debugging details | `kiwilog.debug("Loading configuration")` |
| `info(msg)` | General information | `kiwilog.info("Server started")` |
| `notice(msg)` | Important notices | `kiwilog.notice("Update available")` |
| `success(msg)` | Success messages | `kiwilog.success("Build completed")` |
| `waiting(msg)` | Waiting for action | `kiwilog.waiting("Awaiting input")` |
| `warn(msg)` | Warnings | `kiwilog.warn("Low disk space")` |
| `error(msg)` | Errors | `kiwilog.error("Failed to connect")` |
| `critical(msg)` | Fatal or critical errors | `kiwilog.critical("Database unavailable")` |

---

# 🌀 Loading Animation

Show a beautiful loading animation for long-running tasks:

```python
with kiwilog.loading("Processing data"):
    time.sleep(3)
    # Your work here
kiwilog.success("Data processed!")
```


---

# 📦 Installation

```bash
pip install kiwilog
```

---

# ⚙️ Configuration

You can now configure KiwiLog to suit your needs:

```python
import kiwilog

kiwilog.configure(
    level="DEBUG",               # Minimum log level
    log_to_file=True,           # Enable/disable file logging
    log_file="logs/my_bot.log", # Custom log path
    show_timestamp=True,        # Show [HH:MM:SS] in console
    show_filename=True          # Show [filename.py] in console
)
```

### Log Levels
Available levels: `DEBUG`, `INFO`, `SUCCESS`, `WARN`, `ERROR`, `CRITICAL`.
Default is `INFO`.
