Metadata-Version: 2.2
Name: xylogger
Version: 1.0.0
Summary: Ultimate console logging library with gradient colors, progress bars, tables, and more
Author-email: ZeoN <zeon@example.com>
License: MIT
Project-URL: Homepage, https://github.com/zeon/xylogger
Project-URL: Repository, https://github.com/zeon/xylogger
Keywords: logging,console,colors,gradient,cli,terminal
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Logging
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

# 🎨 Xylogger

**Ultimate console logging library with gradient colors, progress bars, tables, and more.**

[![PyPI version](https://badge.fury.io/py/xylogger.svg)](https://pypi.org/project/xylogger/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Installation

```bash
pip install xylogger
```

## Quick Start

```python
from xylogger import console

console.info("This is an info message")
console.success("Operation completed successfully")
console.warning("This is a warning")
console.error("Something went wrong")
console.section("My Section Title")
```

## Features

### 🎨 Colored Logging
```python
from xylogger import console

console.info("Information message")
console.success("Success message")
console.warning("Warning message")
console.error("Error message")
console.debug("Debug message")
console.critical("Critical message")
```

### 🌈 Gradient Text
```python
from xylogger import console

console.gradient_print("Beautiful gradient text!", (255, 0, 0), (0, 0, 255))
console.section("Gradient Section", start_rgb=(189, 147, 249), end_rgb=(139, 233, 253))
```

### 📊 Progress Bars
```python
from xylogger import ProgressBar
import time

with ProgressBar(total=100, description="Processing") as pb:
    for i in range(100):
        time.sleep(0.02)
        pb.update(1)
```

### 📋 Tables
```python
from xylogger import Table

table = Table(["Name", "Age", "City"])
table.add_row(["Alice", "25", "NYC"])
table.add_row(["Bob", "30", "LA"])
table.print()
```

### ⏱️ Timers
```python
from xylogger import Timer

with Timer("My Operation"):
    time.sleep(1)
```

### 🔄 Spinners
```python
from xylogger import Spinner
import time

with Spinner("Loading..."):
    time.sleep(2)
```

### 📁 File Logging
```python
from xylogger import Logger, FileHandler

logger = Logger()
logger.add_handler(FileHandler("app.log"))
logger.info("This goes to console and file")
```

### 🎭 Custom Themes
```python
from xylogger import Logger, Theme

logger = Logger(theme=Theme.NORD)
logger.info("Styled with Nord theme")
```

## API Reference

### Logger Methods
- `info(message)` - Information message
- `success(message)` - Success message  
- `warning(message)` - Warning message
- `error(message, error=None)` - Error message with optional exception
- `debug(message)` - Debug message
- `critical(message)` - Critical message
- `section(title, start_rgb, end_rgb)` - Section header with gradient
- `gradient_print(text, start_rgb, end_rgb)` - Gradient colored text

### Extras
- `ProgressBar` - Animated progress bar
- `Spinner` - Loading spinner
- `Table` - Formatted table output
- `Timer` - Execution timer
- `Panel` - Boxed content

### Decorators
- `@log_calls` - Log function calls
- `@timer` - Time function execution

## License

MIT License - see [LICENSE](LICENSE) for details.
