EOF-413-LLS 1.1.0__py3-none-any.whl

LLS/__init__.py

@@ -0,0 +1,5 @@
+from .logger import log_init
+
+__all__ = [
+    'log_init'
+]

LLS/logger.py

@@ -0,0 +1,275 @@
+"""
+Модуль для настройки и использования многоуровневого логирования.
+Логи разделяются по категориям (critical, errors, warnings, info, debug)
+и сохраняются в отдельные файлы, а также в общий лог-файл.
+Автоматически удаляются старые файлы, остаются последние `keep` штук.
+"""
+
+from os import (
+    path,
+    remove,
+    listdir,
+    getcwd,
+    makedirs
+)
+
+from logging import (
+    Filter,
+    LogRecord,
+    Formatter,
+    getLogger,
+    DEBUG,
+    INFO,
+    WARNING,
+    ERROR,
+    CRITICAL
+
+)
+
+from logging.handlers import RotatingFileHandler
+
+from datetime import datetime
+
+
+class LevelFilter(Filter):
+    """
+    Фильтр, пропускающий записи только с указанными уровнями логирования.
+    """
+
+    def __init__(self, levels):
+        self.levels = levels
+        super().__init__()
+
+    def filter(self, record):
+        return record.levelno in self.levels
+
+
+class LoggerSystem():
+    """
+    Синглтон-класс для управления логгером в заданной папке.
+    Для каждой папки (folder) создаётся отдельный экземпляр.
+    """
+
+    _inst = {}
+    _global_st = datetime.now()
+
+    def __new__(cls, folder, max_folders=5):
+        if folder not in cls._inst:
+            instance = super().__new__(cls)
+            instance._initialized = False
+            cls._inst[folder] = instance
+        return cls._inst[folder]
+
+    def __init__(self, folder="default", max_folders=5):
+        """
+        Инициализация экземпляра. Выполняется только один раз для каждой папки.
+        :param folder: имя папки для хранения логов (подпапка в logs/)
+        :param max_folders: количество последних файлов, которые сохраняются в каждой категории
+        """
+        if self._initialized:
+            return
+
+        self.folder = folder
+        self.max_folders = max_folders
+
+        self.logger = None
+        self._all_file = None
+        self.start_time = LoggerSystem._global_st
+
+    def _clear(self, dir):
+        """
+        Удаляет старые .log-файлы в директории, оставляя только последние self.keep штук.
+        Сортировка по имени файла (предполагается, что имена содержат временную метку).
+        """
+
+        if not path.exists(dir):
+            return
+
+        files = [f for f in listdir(dir) if f.endswith('.log')]
+
+        if len(files) <= self.max_folders:
+            return
+
+        files.sort()
+        for old in files[:-self.max_folders]:
+            try:
+                remove(path.join(dir, old))
+            except OSError:
+                pass
+
+    @staticmethod
+    def _format(level, msg):
+        """
+        Форматирует запись для ручной записи в лог-файл (используется при инициализации).
+        """
+
+        formatter = Formatter(
+            '[%(asctime)s] [%(levelname)s] [%(filename)s] '
+            '[%(funcName)s] [%(lineno)d] -> %(message)s',
+            datefmt='%d.%m.%Y %H:%M:%S'
+        )
+
+        record = LogRecord(
+            name='logger.py',
+            level=level,
+            pathname='logger.py',
+            lineno=0,
+            msg=msg,
+            args=(),
+            exc_info=None,
+            func='<module>'
+        )
+
+        record.asctime = datetime.now().strftime('%d.%m.%Y %H:%M:%S')
+        return formatter.format(record)
+
+    def _write(self, log_file):
+        """
+        Записывает в новый лог-файл сообщение об инициализации для данной папки.
+        """
+
+        msg = (f"Логирование инициализировано для [{self.folder}]: {self.start_time.strftime('%H:%M:%S %d.%m.%Y')}.")
+
+        with open(log_file, 'a', encoding='utf-8') as f:
+            f.write(self._format(INFO, msg) + '\n')
+
+    def _path(self, category):
+        """
+        Создаёт директорию для категории и возвращает путь к файлу лога.
+        Если файл не существует, записывает начальное сообщение.
+        После создания выполняет очистку старых файлов.
+        """
+
+        logs_dir = path.join(getcwd(), "logs", self.folder)
+
+        category_dir = path.join(logs_dir, category)
+
+        makedirs(category_dir, exist_ok=True)
+
+        time_str = self.start_time.strftime("%H.%M.%S_%d.%m.%Y")
+
+        log_file = path.join(category_dir, f"{time_str}.log")
+
+        if not path.exists(log_file):
+            self._write(log_file)
+
+        self._clear(category_dir)
+        return log_file
+
+    def _all(self):
+        """
+        Создаёт директорию 'all' и возвращает путь к глобальному лог-файлу.
+        При первом создании записывает сообщение о глобальной инициализации.
+        """
+
+        all_dir = path.join(getcwd(), "logs", "all")
+
+        makedirs(all_dir, exist_ok=True)
+
+        time_str = self.start_time.strftime("%H.%M.%S_%d.%m.%Y")
+
+        log_file = path.join(all_dir, f"{time_str}.log")
+
+        self._all_file = log_file
+
+        if not path.exists(log_file):
+            msg = (f"Глобальное логирование инициализировано: {self.start_time.strftime('%H:%M:%S %d.%m.%Y')}.")
+
+            with open(log_file, 'a', encoding='utf-8') as f:
+                f.write(self._format(INFO, msg) + '\n')
+
+        self._clear(all_dir)
+        return log_file
+
+    def setup(self):
+        """
+        Настраивает логгер: создаёт обработчики для каждой категории и глобальный обработчик.
+        Вызывается автоматически при первом обращении к логгеру.
+        """
+
+        if self._initialized:
+            return self.logger
+
+        self.logger = getLogger(self.folder)
+        self.logger.setLevel(DEBUG)
+        self.logger.propagate = False
+
+        categories = {
+            "critical": LevelFilter([CRITICAL]),
+            "errors": LevelFilter([ERROR]),
+            "warnings": LevelFilter([WARNING]),
+            "info": LevelFilter([INFO]),
+            "debug": LevelFilter([DEBUG]),
+        }
+
+        formatter = Formatter(
+            '[%(asctime)s] [%(levelname)s] [%(filename)s] '
+            '[%(funcName)s] [%(lineno)d] -> %(message)s',
+            datefmt='%d.%m.%Y %H:%M:%S'
+        )
+
+        for category_name, level_filter in categories.items():
+            log_path = self._path(category_name)
+            handler = RotatingFileHandler(
+                log_path,
+                maxBytes=10 * 1024 * 1024,
+                backupCount=0,
+                encoding='utf-8'
+            )
+            handler.setLevel(DEBUG)
+            handler.addFilter(level_filter)
+            handler.setFormatter(formatter)
+            self.logger.addHandler(handler)
+
+        all_log_path = self._all()
+        all_handler = RotatingFileHandler(
+            all_log_path,
+            maxBytes=10 * 1024 * 1024,
+            backupCount=0,
+            encoding='utf-8'
+        )
+        all_handler.setLevel(DEBUG)
+        all_handler.setFormatter(formatter)
+        self.logger.addHandler(all_handler)
+
+        self._initialized = True
+        return self.logger
+
+    def __getattr__(self, name):
+        """
+        Позволяет обращаться к методам логирования через сокращения:
+        d -> debug, i -> info, w -> warning, e -> error, c -> critical.
+        Также поддерживаются полные имена.
+        """
+        if not self._initialized:
+            self.setup()
+
+        short_names = {
+            'd': 'debug',
+            'i': 'info',
+            'w': 'warning',
+            'e': 'error',
+            'c': 'critical'
+        }
+        if name in short_names:
+            return getattr(self.logger, short_names[name])
+        if name in ['debug', 'info', 'warning', 'error', 'critical']:
+            return getattr(self.logger, name)
+        raise AttributeError(f"'LoggerSystem' object has no attribute '{name}'")
+
+
+_log = {}
+
+
+def log_init(folder="default", max_folders=5):
+    """
+    Фабричная функция для получения экземпляра LoggerSystem для заданной папки.
+    При первом вызове для папки автоматически выполняется настройка.
+    :param folder: имя папки для хранения логов
+    :param max_folders: количество последних файлов, которые сохраняются в каждой категории
+    """
+
+    if folder not in _log:
+        _log[folder] = LoggerSystem(folder, max_folders)
+        _log[folder].setup()
+    return _log[folder]

eof_413_lls-1.1.0.dist-info/METADATA

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: EOF_413_LLS
+Version: 1.1.0
+Summary: Простой многоуровневый логгер с ротацией
+Home-page: https://github.com/EOF-413/LibraryLogSystem
+Author: EOF-413
+Author-email: org.animea@mail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# LibraryLogSystem (LLS)
+
+**LLS** - это универсальная система логирования для Python приложений.
+Позволяет разделять логи по категориям (debug, info, warning, error, critical) и создавать отдельные директории для разных модулей.
+
+## Особенности
+
+- Разделение логов по уровням: debug, info, warning, error, critical
+- Автоматическое создание папок для каждого модуля
+- Общая папка all/ со всеми логами без сортировки
+- Автоматическая очистка старых логов (хранится 5 последних файлов)
+- Singleton паттерн для каждого логгера
+- Поддержка коротких имен методов: d(), i(), w(), e(), c()
+
+## Установка
+
+```python
+from LLS import log_init
+```
+
+## Использование
+
+### Базовое использование
+
+```python
+from LLS import log_init
+
+# Создание логгера для конкретного модуля
+log = log_init('main')
+
+# Запись логов
+log.debug("Отладочное сообщение")
+log.info("Информационное сообщение")
+log.warning("Предупреждение")
+log.error("Ошибка")
+log.critical("Критическая ошибка")
+```
+
+### Короткие имена методов
+
+```python
+from LLS import log_init
+
+log = log_init('main')
+
+log.d("debug")   # debug
+log.i("info")    # info
+log.w("warning") # warning
+log.e("error")   # error
+log.c("critical") # critical
+```
+
+### Использование в разных модулях
+
+```python
+# http/client.py
+from LLS import log_init
+
+log = log_init('http')
+
+log.info("HTTP запрос отправлен")
+
+# github/repository.py
+from LLS import log_init
+
+log = log_init('GitHub')
+
+log.info("Поиск репозиториев")
+```
+
+## Структура логов
+
+```text
+logs/
+├── all/
+│   └── 21.59.18_25.07.2026.log
+├── main/
+│   ├── debug/
+│   ├── info/
+│   ├── warnings/
+│   ├── errors/
+│   └── critical/
+├── http/
+│   ├── debug/
+│   ├── info/
+│   ├── warnings/
+│   ├── errors/
+│   └── critical/
+└── GitHub/
+    ├── debug/
+    ├── info/
+    ├── warnings/
+    ├── errors/
+    └── critical/
+```
+
+## Формат логов
+
+```log
+[25.07.2026 21:59:18] [INFO] [main.py] [<module>] [5] -> Сообщение
+[25.07.2026 21:59:18] [ERROR] [client.py] [get] [25] -> Ошибка запроса
+```
+
+## API
+
+### log_init(folder: str) -> LoggerSystem
+
+Создает или возвращает экземпляр логгера для указанной папки.
+
+Параметры:
+- folder (str): Имя папки для хранения логов (например, "main", "http", "GitHub")
+
+Возвращает:
+- LoggerSystem: Экземпляр логгера
+
+### Методы логгера
+
+| Метод | Короткий | Описание |
+|-------|----------|----------|
+| debug(msg) | d(msg) | Запись отладочного сообщения |
+| info(msg) | i(msg) | Запись информационного сообщения |
+| warning(msg) | w(msg) | Запись предупреждения |
+| error(msg) | e(msg) | Запись ошибки |
+| critical(msg) | c(msg) | Запись критической ошибки |
+
+## Очистка логов
+
+Система автоматически хранит только 5 последних лог-файлов для каждой категории. Старые файлы удаляются автоматически.

eof_413_lls-1.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+LLS/__init__.py,sha256=yLykTMVQnzPraZ67QJJryHe4JBppy9fmtqKyhWbXquE,64
+LLS/logger.py,sha256=fOZRUvpmWUPBDOrWMfgjahnbxy9VNdm7Klt9oJYs5Zc,9702
+eof_413_lls-1.1.0.dist-info/licenses/LICENSE,sha256=0qyiMtrdwoUCfQWtP6Kz6kH7ws2xU_yXRVlmtzdEqzw,1085
+eof_413_lls-1.1.0.dist-info/METADATA,sha256=j6NHCWTdTHTMzDjdFkbuJedyRlMisHadkOvggCkAbr0,4633
+eof_413_lls-1.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+eof_413_lls-1.1.0.dist-info/top_level.txt,sha256=8TWtPNTp3uBGf1jYSutUeeZyZQv8lYjq8kSQZt5jVdo,4
+eof_413_lls-1.1.0.dist-info/RECORD,,

eof_413_lls-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

eof_413_lls-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EOF-413
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eof_413_lls-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+LLS