fsllog 0.2.0
Advanced logging library with colored output, file rotation, and flexible configuration
Requires Python: >=3.8

## README.md (English)

# FSLog - Simple Python Logging Library

> A powerful and flexible logging library with colored console output, file logging, rotation, and custom formatting.

# Features

- 🎨 Colored console output with RGB support

- 📁 File logging with automatic rotation

- 🔄 Dual modes - file-only, console-only, or both

- 📏 Size-based rotation - prevent log files from getting too large

- 🗑️ Automatic cleanup - keep only the newest log files

- ✨ Custom formatting - flexible log message templates

- 🎯 Multiple log prefix - debug, info, warning, error, and custom


## Installation

```bash
pip install fsllog
```
## Simple usage

```python
logger = FSLog()
logger.info("Application started")
logger.error("Something went wrong")
```

## Advanced Usage

```python
logger = FSLog(
    log_folder_path="logs",      # Path to log folder (default: "Logs")
    max_logs=10,                 # Maximum log files to keep (default: 10)
    max_file_size_mb=100,        # Max file size in MB (default: 100)
    log_format="[{timestamp}] [{prefix}] {message}",  # Custom format
    file_only=False,             # Log only to file (default: False)
    console_only=False           # Log only to console (default: False)
)
logger.info("Application started")
logger.error("Something went wrong")
```

## Log Prefix

Method === Default color === Example

.debug() === Cyan === logger.debug.("debug message")
.info() === Blue === logger.info("info message")
.logging() === White === logger.logging("logging message")
.server() === White === logger.server("server event")
.warning() === Yellow === logger.warning("warning message")
.error() === Red === logger.error("error occurred")

### Custom Colors
```python
logger.info("Success!", Colors.GREEN)
logger.custom("Custom message", "AUTH", (255, 165, 0))  # Orange
```
### Advanced Formatting
```python
logger.set_format("{timestamp} | {prefix} | {message}")
```
> Output: [2023.11.15_14-30-00] | [INFO] | Message

#Advanced Features
##File Rotation
```python
# Automatic rotation when file exceeds max_file_size_mb
logger = FSLog(max_file_size_mb=50)  # Rotate at 50MB
```

### Modes
```python
# Console only (no files)
console_logger = FSLog(console_only=True)

# File only (silent operation)
file_logger = FSLog(file_only=True)
```

#Requirements

- Python 3.8+
- No external dependencies

## License

MIT License - see LICENSE file for details
text
⠀
⠀

## **README_RU.md (Russian)**

# FSLog - Простая библиотека логирования на Python

> Мощная и гибкая библиотека для логирования с цветным выводом в консоль, файловым логированием, ротацией и кастомным форматированием.

#Возможности

 - 🎨 Цветной вывод в консоль с поддержкой RGB

 - 📁 Файловое логирование с автоматической ротацией

 - 🔄 Двойные режимы - только файл, только консоль или оба

 - 📏 Ротация по размеру - предотвращает рост файлов логов

 - 🗑️ Автоматическая очистка - сохраняет только новые файлы логов

 - ✨ Кастомное форматирование - гибкие шаблоны сообщений

 - 🎯 Несколько уровней логирования - debug, info, warning, error и кастомные

## Установка

```bash
pip install fsllog
```

## Простое использование
```python
logger = FSLog(log_folder_path="logs", max_logs=5)
logger.info("Приложение запущено")
logger.error("Произошла ошибка")
```

## Продвинутое использование

```python
logger = FSLog(
    log_folder_path="logs",      # Путь к папке логов (по умолчанию: "Logs")
    max_logs=10,                 # Максимум файлов логов (по умолчанию: 10)
    max_file_size_mb=100,        # Макс. размер файла в МБ (по умолчанию: 100)
    log_format="[{timestamp}] [{prefix}] {message}",  # Кастомный формат
    file_only=False,             # Только файловое логирование
    console_only=False           # Только консольное логирование
)
logger.info("Приложение запущено")
logger.error("Произошла ошибка")
```

## Префиксы логов

Метод === Цвет по умолчанию === Пример

.debug() === Голубой === logger.debug("Отладочное сообщение")
.info() === Синий === logger.info("Информация")
.logging() === Белый === logger.logging("Общее сообщение")
.server() === Белый === logger.server("Событие сервера")
.warning() === Желтый === logger.warning("Предупреждение")
.error() === Красный === logger.error("Произошла ошибка")

## Кастомные цвета
```python
logger.info("Успех!", Colors.GREEN)
logger.custom("Кастомное сообщение", "AUTH", (255, 165, 0))  # Оранжевый
```

## Расширенное форматирование
```python
logger.set_format("{timestamp} | {prefix} | {message}")
```

> Вывод: [2023.11.15_14-30-00] | [INFO] | Сообщение

#Расширенные возможности

## Ротация логов

```python
Автоматическая ротация при превышении max_file_size_mb
logger = FSLog(max_file_size_mb=50)  # Ротация при 50МБ
```

# Режимы работы

## Только консоль (без файлов)
```python
console_logger = FSLog(console_only=True)
```

## Только файлы (тихая работа)
```python
file_logger = FSLog(file_only=True)
```

#Требования

 - Python 3.8+
 - Нет внешних зависимостей