Metadata-Version: 2.4
Name: loggity
Version: 0.1.0a0
Summary: A simple, beautiful logger with a clean and intuitive interface
Author: slpuk
License: MIT
Project-URL: Homepage, https://github.com/slpuk/loggity
Project-URL: Documentation, https://github.com/slpuk/loggity#readme
Project-URL: Repository, https://github.com/slpuk/loggity
Project-URL: Issue Tracker, https://github.com/slpuk/loggity/issues
Keywords: logging,logger,log,terminal,console,pretty,simple,beautiful,cli,stdout,debug,info,warn,error,success,formatter,output,python-logging,log-messages,logging-library
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Communications
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Dynamic: license-file

# Loggity
> A simple, beautiful logger with a clean and intuitive interface

![Protocol Version](https://img.shields.io/badge/version-0.1.0-blue?style=for-the-badge)
![Development Status](https://img.shields.io/badge/status-alpha-red?style=for-the-badge)
![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)
![Python](https://img.shields.io/badge/python-3.7+-blue?style=for-the-badge&logo=python&logoColor=white)

## Features

- **Simple API**: Just create a logger and start logging
- **Multiple log levels**: INFO, WARN, ERROR, DEBUG, SUCCESS
- **Custom headers**: Create your own log types
- **Minimal dependencies**: Pure Python, no external packages required
- **Clean output**: Formatted logs with consistent spacing

## Installation

```bash
pip install loggity
```

## Quick Start

```python
from loggity import Logger

# Create a logger instance
log = Logger()

# Start logging
log.info("Application started")
log.success("Database connected successfully")
log.warn("Disk space running low")
log.error("Failed to send email")
log.debug("Cache miss for key: user_123")
```

## API Reference

### Basic Methods

| Method | Description | Example |
|--------|-------------|---------|
| `info(message)` | Informational messages | `log.info("Server started on port 8080")` |
| `warn(message)` | Warning messages | `log.warn("API rate limit at 90%")` |
| `error(message)` | Error messages | `log.error("Connection timeout")` |
| `debug(message)` | Debug messages | `log.debug("Request payload: {...}")` |
| `success(message)` | Success messages | `log.success("Data exported")` |

### Custom Logging

Create logs with any header using the `custom()` method:

```python
# Custom log types
log.custom("AUDIT", "User admin performed deletion")
log.custom("METRIC", "Response time: 245ms")
log.custom("SECURITY", "Failed login attempt from 192.168.1.100")
log.custom("PERFORMANCE", "Query executed in 0.3s")
```

## Output Format

All logs follow a consistent format:
```
HEADER:    message
```

Examples:
```
INFO:    Application started
SUCCS:   Database connected
WARN:    Disk space low
ERROR:   Connection failed
DEBUG:   Cache miss
AUDIT:   User logged in
```

## License
This project is licensed under the [MIT License](LICENSE).
