fsllog 0.2.0

Advanced logging library with colored output, file rotation, and flexible configuration

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

pip install fsllog

Simple usage

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

Advanced Usage

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

logger.info("Success!", Colors.GREEN)
logger.custom("Custom message", "AUTH", (255, 165, 0))  # Orange

Advanced Formatting

logger.set_format("{timestamp} | {prefix} | {message}")

Output: [2023.11.15_14-30-00] | [INFO] | Message

#Advanced Features ##File Rotation

# Automatic rotation when file exceeds max_file_size_mb
logger = FSLog(max_file_size_mb=50)  # Rotate at 50MB

Modes

# 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 и кастомные

Установка

pip install fsllog

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

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

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

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("Произошла ошибка")

Кастомные цвета

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

Расширенное форматирование

logger.set_format("{timestamp} | {prefix} | {message}")

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

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

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

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

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

Только консоль (без файлов)

console_logger = FSLog(console_only=True)

Только файлы (тихая работа)

file_logger = FSLog(file_only=True)

#Требования

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