Metadata-Version: 2.4
Name: logfore
Version: 2.1.3.2
Summary: A colorful and feature-rich logging library for Python
Home-page: https://github.com/yourusername/logfore
Author: 
Author-email: 
License: MIT
Project-URL: Homepage, https://github.com/yourusername/logfore
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama
Requires-Dist: pystyle
Requires-Dist: requests
Requires-Dist: packaging
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# logfore

A colorful, feature-rich logging library for Python with support for styled output, loading animations, ASCII banners, and auto-updates.

## Installation

```bash
pip install logfore
```

## Quick Start

```python
from logfore import Logger, Loader, Home, LogLevel

# Basic logger (colorful style)
log = Logger(prefix="MyApp")

log.info("Application started")
log.success("Task completed")
log.warning("Low memory")
log.failure("Connection lost")
log.error("Something went wrong")
log.debug("Debug message")
log.critical("Fatal error occurred")  # exits program

# Simple/minimal style
log2 = Logger(style=2, prefix="MyApp")
log2.info("Simple style log")
```

## Features

### Logger Styles

| Style | Description |
|-------|-------------|
| `style=1` | Colorful logger with pink/cyan/magenta theme (default) |
| `style=2` | Minimal simple logger with arrow prefix |

### Logger Options

```python
log = Logger(
    style=1,                          # 1 = ColorLogger, 2 = SimpleLogger
    prefix="MyApp",                   # Prefix shown in brackets
    github_repository="user/repo",    # Displays repo info on start
    level=LogLevel.DEBUG,             # Minimum log level to display
    log_file="logs/app.log"           # Optional file logging
)
```

### Log Levels

```python
from logfore import LogLevel

# Available levels (in order):
LogLevel.DEBUG
LogLevel.INFO
LogLevel.WARNING
LogLevel.SUCCESS
LogLevel.FAILURE
LogLevel.CRITICAL
```

### Timing Support

All log methods support optional timing:

```python
import time

start = time.time()
# ... do work ...
end = time.time()

log.success("Done!", start=start, end=end)
# Output: ... [Success] -> Done! In 1.234 Seconds
```

### Loading Spinner

```python
from logfore import Loader

# As context manager
with Loader(prefix="MyApp", desc="Processing...", end="Done!"):
    time.sleep(2)

# Manual control
loader = Loader(desc="Loading...")
loader.start()
# ... do work ...
loader.stop()
```

### ASCII Banner (Home Screen)

```python
from logfore import Home

home = Home(
    text="LOGFORE",
    align="center",       # "left", "center", "right"
    adinfo1="v1.0.0",
    adinfo2="by Author",
    credits="GitHub: user",
    clear=True            # Clear terminal before display
)
home.display()
```

### Auto Updater

```python
from logfore import AutoUpdater, Logger

log = Logger()
updater = AutoUpdater("your-pypi-package-name", log)
updater.check_for_updates()
```

### File Logging

```python
log = Logger(log_file="logs/myapp.log")
log.info("This is saved to file too")
```

## Questions / Input

```python
answer = log.question("What is your name? ")
print(f"Hello, {answer}!")
```

## Requirements

- Python 3.10+
- colorama
- pystyle
- requests
- packaging
