1.2 Вроде все готово

BotLibrary/loggers/__init__.py

@@ -4,4 +4,5 @@
 # Экспортирование модулей во внешние слои проекта
 from .logs import *
 from .msg_logger import *
+from .custom_loggers import *
 from .start_info_out import *

BotLibrary/loggers/custom_loggers.py

@@ -0,0 +1,69 @@
+# BotLibrary/loggers/custom_loggers.py
+# Кастомные логгеры для проекта, с более стандартизированным использованием
+
+from loguru import logger
+from ..validators import username
+from aiogram.types import Message
+
+# Настройка экспорта из модуля
+__all__ = ("Logs",)
+
+
+class Logs:
+    """Класс для логирования с разными уровнями через loguru."""
+
+    @staticmethod
+    def debug(text: str = "Логирование!", log_type: str = "Logs", user: str = "Console", message: Message = None) -> None:
+        """
+        Логирует сообщение на уровне DEBUG.
+
+        :param text: Сообщение для логирования.
+        :param log_type: Тип лога (например, "Logs").
+        :param user: Имя пользователя или источник вызова лога.
+        :param message: Сообщение от пользователя, если необходимо извлечь имя.
+        """
+        if message:
+            user = username(message)
+        logger.bind(log_type=log_type, user=user).debug(text)
+
+    @staticmethod
+    def info(text: str = "Логирование!", log_type: str = "Logs", user: str = "Console", message: Message = None) -> None:
+        """
+        Логирует сообщение на уровне INFO.
+
+        :param text: Сообщение для логирования.
+        :param log_type: Тип лога (например, "Logs").
+        :param user: Имя пользователя или источник вызова лога.
+        :param message: Сообщение от пользователя, если необходимо извлечь имя.
+        """
+        if message:
+            user = username(message)
+        logger.bind(log_type=log_type, user=user).info(text)
+
+    @staticmethod
+    def warning(text: str = "Логирование!", log_type: str = "Logs", user: str = "Console", message: Message = None) -> None:
+        """
+        Логирует сообщение на уровне WARNING.
+
+        :param text: Сообщение для логирования.
+        :param log_type: Тип лога (например, "Logs").
+        :param user: Имя пользователя или источник вызова лога.
+        :param message: Сообщение от пользователя, если необходимо извлечь имя.
+        """
+        if message:
+            user = username(message)
+        logger.bind(log_type=log_type, user=user).warning(text)
+
+    @staticmethod
+    def error(text: str = "Логирование!", log_type: str = "Logs", user: str = "Console", message: Message = None) -> None:
+        """
+        Логирует сообщение на уровне ERROR.
+
+        :param text: Сообщение для логирования.
+        :param log_type: Тип лога (например, "Logs").
+        :param user: Имя пользователя или источник вызова лога.
+        :param message: Сообщение от пользователя, если необходимо извлечь имя.
+        """
+        if message:
+            user = username(message)
+        logger.bind(log_type=log_type, user=user).error(text)

BotLibrary/loggers/logs.py

@@ -5,34 +5,55 @@ import sys
 from loguru import logger
 from ProjectsFiles import BotLogs
 
+
 # Создание обычного логгера + логгер в файл
-async def setup_logger():
+async def setup_logger() -> None:
+    """
+    Настройка логгеров для проекта, выводящих логи в консоль.
+    Логгеры конфигурируются в зависимости от настроек в BotLogs.
+
+    Если разрешено логирование, добавляются логи для уровней DEBUG, INFO, WARNING, ERROR.
+    """
     logger.remove()  # Удаляем все логгеры
 
+    # Настройка логирования в консоль для каждого уровня
     if BotLogs.permission:
+        logger.add(sys.stderr,
+                   colorize=True,
+                   format=BotLogs.debug_text,
+                   level="DEBUG",
+                   filter=lambda record: record["level"].name == "DEBUG")
         logger.add(sys.stderr,
                    colorize=True,
                    format=BotLogs.info_text,
                    level="INFO",
                    filter=lambda record: record["level"].name == "INFO")
+        logger.add(sys.stderr,
+                   colorize=True,
+                   format=BotLogs.warning_text,
+                   level="WARNING",
+                   filter=lambda record: record["level"].name == "WARNING")
         logger.add(sys.stderr,
                    colorize=True,
                    format=BotLogs.error_text,
                    level="ERROR",
                    filter=lambda record: record["level"].name == "ERROR")
 
-    if BotLogs.permission:
-         """logger.add(ProjectPath.log_file,
-                    rotation=BotLogs.max_size,
-                    format=BotLogs.info_text,
-                    backtrace=True,
-                    diagnose=True,
-                    level="INFO",
-                    filter=lambda record: record["level"].name == "INFO")
-         logger.add(ProjectPath.log_error_file,
-                    rotation=BotLogs.max_size,
-                    format=BotLogs.error_text,
-                    backtrace=True,
-                    diagnose=True,
-                    level="ERROR",
-                    filter=lambda record: record["level"].name == "ERROR")"""
+    # Добавление логгера для записи в файл (закомментированное, по необходимости активируется)
+    if BotLogs.permission_to_file:
+        # Uncomment and adjust if file logging is required
+        # logger.add(ProjectPath.log_file,
+        #            rotation=BotLogs.max_size,
+        #            format=BotLogs.info_text,
+        #            backtrace=True,
+        #            diagnose=True,
+        #            level="INFO",
+        #            filter=lambda record: record["level"].name == "INFO")
+        # logger.add(ProjectPath.log_error_file,
+        #            rotation=BotLogs.max_size,
+        #            format=BotLogs.error_text,
+        #            backtrace=True,
+        #            diagnose=True,
+        #            level="ERROR",
+        #            filter=lambda record: record["level"].name == "ERROR")
+        return

BotLibrary/loggers/msg_logger.py

@@ -1,19 +1,29 @@
 # BotLibrary/loggers/msg_logger.py
 # Логгер для всех не обработанных сообщений
 
-from .logs import logger
 from ProjectsFiles import BotLogs
+from .custom_loggers import Logs
 from ..analytics.type_msg import types_message
+from aiogram.types import Message
 
 # Настройка экспорта из модуля
 __all__ = ("logger_msg",)
 
 # Создание функции логирования на обычные сообщения
-async def logger_msg(message, log_type : str = "Message"):
-    user = f"@{message.from_user.username or message.from_user.id}"
+async def logger_msg(message: Message, log_type: str = "Message") -> None:
+    """
+    Логирует сообщение, если оно не обработано.
+
+    :param message: Сообщение от пользователя.
+    :param log_type: Тип лога (по умолчанию "Message").
+    """
+    # Получаем username или id пользователя
+    user: str = f"@{message.from_user.username or message.from_user.id}"
+
+    # Логирование только если разрешено
     if BotLogs.permission:
         # Проверка на наличие текста и его типа
         if message.text is None:
-            logger.bind(log_type=log_type, user=user).info(f"Получено сообщение из ({message.chat.id}) : {types_message(message)}")
+            Logs.info(log_type=log_type, user=user, text=f"Получено сообщение из ({message.chat.id}) : {types_message(message)}")
         else:
-            logger.bind(log_type=log_type, user=user).info(f"Получено сообщение из ({message.chat.id}) : {message.text}")
+            Logs.info(log_type=log_type, user=user, text=f"Получено сообщение из ({message.chat.id}) : {message.text}")

BotLibrary/loggers/start_info_out.py

@@ -3,33 +3,37 @@
 
 from time import sleep
 from colorama import Fore
-
 from ProjectsFiles import Permissions
-from .logs import logger
+from .custom_loggers import Logs
 from ..system import BotInfo
 
-
 # Функция для получения информации о боте и выводе ее в консоль и файл
-def bot_info_out():
+def bot_info_out() -> str:
+    """
+    Собирает информацию о боте и выводит её в консоль, а также возвращает как строку.
+
+    :return: Информация о боте в виде строки.
+    """
     try:
-        bot_name = f"Основное имя: {BotInfo.first_name}\n"
-        bot_post_name = f" Доп. имя: {BotInfo.last_name}\n"
-        bot_username = f" Юзернейм: @{BotInfo.username}\n"
-        bot_id = f" ID: {BotInfo.id}\n"
-        bot_language = f" Языковой код: {BotInfo.language_code}\n"
-        bot_can_join_groups = f" Может ли вступать в группы: {BotInfo.can_join_groups}\n"
-        bot_can_read_all_group_messages = f" Чтение всех сообщений: {BotInfo.can_read_all_group_messages}\n"
-        bot_is_premium = f" Является премиум-ботом: {BotInfo.is_premium}\n"
-        bot_added_to_attachment_menu = f" Добавлен в меню вложений: {BotInfo.added_to_attachment_menu}\n"
-        bot_supports_inline_queries = f" Поддерживает инлайн-запросы: {BotInfo.supports_inline_queries}\n"
-        bot_can_connect_to_business = f" Подключение к бизнес-аккаунтам: {BotInfo.can_connect_to_business}\n"
-        bot_has_main_web_app = f" Основное веб-приложение: {BotInfo.has_main_web_app}\n"
+        # Собираем данные о боте
+        bot_name: str = f"Основное имя: {BotInfo.first_name}\n"
+        bot_post_name: str = f"Доп. имя: {BotInfo.last_name}\n"
+        bot_username: str = f"Юзернейм: @{BotInfo.username}\n"
+        bot_id: str = f"ID: {BotInfo.id}\n"
+        bot_language: str = f"Языковой код: {BotInfo.language_code}\n"
+        bot_can_join_groups: str = f"Может ли вступать в группы: {BotInfo.can_join_groups}\n"
+        bot_can_read_all_group_messages: str = f"Чтение всех сообщений: {BotInfo.can_read_all_group_messages}\n"
+        bot_is_premium: str = f"Является премиум-ботом: {BotInfo.is_premium}\n"
+        bot_added_to_attachment_menu: str = f"Добавлен в меню вложений: {BotInfo.added_to_attachment_menu}\n"
+        bot_supports_inline_queries: str = f"Поддерживает инлайн-запросы: {BotInfo.supports_inline_queries}\n"
+        bot_can_connect_to_business: str = f"Подключение к бизнес-аккаунтам: {BotInfo.can_connect_to_business}\n"
+        bot_has_main_web_app: str = f"Основное веб-приложение: {BotInfo.has_main_web_app}\n"
 
         # Формируем полный текст с выводом информации о боте
-        bot_all_info = (f"{bot_name} {bot_post_name} {bot_username} {bot_id} {bot_language} "
-                        f"{bot_can_join_groups} {bot_can_read_all_group_messages} {bot_is_premium} "
-                        f"{bot_added_to_attachment_menu} {bot_supports_inline_queries} {bot_can_connect_to_business} "
-                        f"{bot_has_main_web_app}")
+        bot_all_info: str = (f"{bot_name} {bot_post_name} {bot_username} {bot_id} {bot_language} "
+                             f"{bot_can_join_groups} {bot_can_read_all_group_messages} {bot_is_premium} "
+                             f"{bot_added_to_attachment_menu} {bot_supports_inline_queries} {bot_can_connect_to_business} "
+                             f"{bot_has_main_web_app}")
 
         # Печатаем все данные в консоль с задержкой в 1 секунду
         sleep(1)
@@ -38,6 +42,5 @@ def bot_info_out():
 
         return bot_all_info
 
-    # Проверка на ошибку и ее логирование
     except Exception as e:
-        logger.bind(log_type="INFO", user="Start_INFO").error(f"Ошибка при получении ID пользователя: {e}")
+        Logs.error(log_type="INFO", user="Start_INFO", text=f"Ошибка при получении ID пользователя: {e}")