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

2025-02-24 00:54:00 +07:00
parent 410b8eff59
commit 61241a2cf4
17 changed files with 385 additions and 171 deletions
--- a/BotLibrary/system/bot_edit.py
+++ b/BotLibrary/system/bot_edit.py
@@ -4,13 +4,18 @@
 from aiogram.types import ChatAdministratorRights
 from ProjectsFiles import BotEdit
 from .bots import bot
-from ..loggers import logger
+from ..loggers import Logs

 # Настройка логирования
 log_type = "Edit"

 # Функция для выполнения всех настроек, если они не совпадают
-async def set_all():
+async def set_all() -> None:
+    """
+    Выполняет все необходимые настройки бота, если они не совпадают с текущими значениями.
+
+    :return: None
+    """
    await set_adm_rights()
    await set_bot_name()
    await set_bot_description()
@@ -18,8 +23,12 @@ async def set_all():


 # Функция установки прав администратора
-async def set_adm_rights():
-    # Применить права администратора для бота
+async def set_adm_rights() -> None:
+    """
+    Устанавливает права администратора для бота, если они отличаются от текущих.
+
+    :return: None
+    """
    rights = ChatAdministratorRights(
        is_anonymous=BotEdit.is_anonymous,
        can_manage_chat=BotEdit.manage_chat,
@@ -45,15 +54,18 @@ async def set_adm_rights():


 # Функция установки имени бота с проверкой на ограничения
-async def set_bot_name():
+async def set_bot_name() -> None:
+    """
+    Устанавливает имя бота, если оно отличается от текущего и соответствует ограничениям.
+
+    :return: None
+    """
    # Получаем текущее имя бота
    current_name = (await bot.get_me()).first_name

    # Проверка длины имени
    if len(BotEdit.name) < 1 or len(BotEdit.name) > 32:
-        # Логируем ошибку, если имя не соответствует ограничению
-        (logger.bind(log_type=log_type, user="NAME_BOT")
-         .error("Имя бота должно быть от 1 до 32 символов."))
+        Logs.error(log_type=log_type, user="NAME_BOT", text="Имя бота должно быть от 1 до 32 символов.")

    # Проверяем, совпадает ли текущее имя с тем, которое мы хотим установить
    if current_name != BotEdit.name:
@@ -61,14 +73,18 @@ async def set_bot_name():


 # Функция установки описания бота с проверкой на ограничения
-async def set_bot_description():
+async def set_bot_description() -> None:
+    """
+    Устанавливает описание бота, если оно отличается от текущего и соответствует ограничениям.
+
+    :return: None
+    """
    # Получаем текущее описание бота
    current_description = await bot.get_my_description()

    # Проверка длины описания
    if len(BotEdit.description) > 255:
-        (logger.bind(log_type=log_type, user="DISCRIPT")
-         .error("Короткое описание бота не может превышать 255 символов."))
+        Logs.error(log_type=log_type, user="DISCRIPT", text="Короткое описание бота не может превышать 255 символов.")

    # Проверяем, совпадает ли текущее описание с тем, которое мы хотим установить
    if current_description != BotEdit.description:
@@ -76,14 +92,18 @@ async def set_bot_description():


 # Функция установки короткого описания бота с проверкой на ограничения
-async def set_bot_short_description():
+async def set_bot_short_description() -> None:
+    """
+    Устанавливает короткое описание бота, если оно отличается от текущего и соответствует ограничениям.
+
+    :return: None
+    """
    # Получаем текущее короткое описание бота
    current_short_description = await bot.get_my_short_description()

    # Проверка длины короткого описания
    if len(BotEdit.short_description) > 512:
-        (logger.bind(log_type=log_type, user="SHORT_DISCRIPT")
-         .error("Описание виджета не может превышать 512 символов."))
+        Logs.error(log_type=log_type, user="SHORT_DISCRIPT", text="Описание виджета не может превышать 512 символов.")

    # Проверяем, совпадает ли текущее короткое описание с тем, которое мы хотим установить
    if current_short_description != BotEdit.short_description:
--- a/BotLibrary/system/bots.py
+++ b/BotLibrary/system/bots.py
@@ -5,17 +5,18 @@ from aiogram import Dispatcher, Bot, F
 from aiogram.enums import ParseMode
 from aiogram.client.default import DefaultBotProperties
 from aiogram.utils.keyboard import InlineKeyboardBuilder, ReplyKeyboardBuilder
+from aiogram.types import Bot as BotType

-from ..timer import *
-from ProjectsFiles import *
+from ..timer import get_host_time, get_moscow_time
+from ProjectsFiles import bot_token, BotVar

-# Создание экземпляра диспатчера, строителей кнопок
-dp = Dispatcher()
+
+# Создание строителей кнопок
 rkb = ReplyKeyboardBuilder()
 ikb = InlineKeyboardBuilder()

-
 # Настройка параметров диспатчера
+dp = Dispatcher()
 dp["started_at"] = get_host_time()
 dp["started_at_msk"] = get_moscow_time()
 dp["is_active"] = True  # Флаг активности бота
@@ -32,8 +33,7 @@ dp["handlers"] = {"on_message": [], "on_error": []}
 dp["storage"] = {}
 dp["database"] = None

-
-# Объявление экземпляров и переменных
+# Настройки для бота
 bot_properties = DefaultBotProperties(
    parse_mode=ParseMode.HTML,  # Устанавливаем формат HTML для всех сообщений
    disable_notification=True,  # Отключаем уведомления при отправке сообщений
@@ -42,39 +42,49 @@ bot_properties = DefaultBotProperties(
    link_preview_is_disabled=True,  # Отключаем предварительный просмотр ссылок
    show_caption_above_media=False,  # Показываем подпись выше медиа
 )
-bot = Bot(token=bot_token, default=bot_properties)     # Объявление бота
-F_Media = F.photo | F.files | F.video | F.animation | F.voice | F.video_note  # Фильтр-медиа
-F_All = F.text | F.photo | F.files | F.video | F.animation | F.voice | F.video_note # Фильтр на все

+# Создание экземпляра бота
+bot = Bot(token=bot_token, default=bot_properties)  # Объявление бота

-# Класс для хранения данных о боте (некоторые переменные даны как шаблон)
+# Фильтры для различных типов сообщений
+F_Media = F.photo | F.files | F.video | F.animation | F.voice | F.video_note  # Фильтр для медиа
+F_All = F.text | F.photo | F.files | F.video | F.animation | F.voice | F.video_note  # Фильтр на все
+
+# Класс для хранения данных о боте
 class BotInfo:
+    """
+    Класс для хранения данных о боте и их обновления.
+    """
    # Статические переменные для хранения данных
-    id = None
-    first_name = None
-    last_name = None
-    username = None
-    description = None
-    short_description = None
-    can_join_groups = None
-    can_read_all_group_messages = None
-    language_code = BotVar.language
-    prefix = BotVar.prefix
-    is_premium = None
-    added_to_attachment_menu = None
-    supports_inline_queries = None
-    can_connect_to_business = None
-    has_main_web_app = None
+    id: int = None
+    first_name: str = None
+    last_name: str = None
+    username: str = None
+    description: str = None
+    short_description: str = None
+    can_join_groups: bool = None
+    can_read_all_group_messages: bool = None
+    language_code: str = BotVar.language
+    prefix: str = BotVar.prefix
+    is_premium: bool = None
+    added_to_attachment_menu: bool = None
+    supports_inline_queries: bool = None
+    can_connect_to_business: bool = None
+    has_main_web_app: bool = None

-    # Метод для обновления данных
    @classmethod
-    def update(cls, bot_info):
+    def update(cls, bot_info) -> None:
+        """
+        Обновляет данные о боте.
+
+        :param bot_info: Объект с данными о боте, полученные через API Telegram.
+        """
        cls.id = bot_info.id
        cls.first_name = bot_info.first_name
        cls.last_name = bot_info.last_name
        cls.username = bot_info.username
        cls.description = getattr(bot_info, 'description', '')
-        cls.short_description = getattr(bot_info, 'description', '')
+        cls.short_description = getattr(bot_info, 'short_description', '')
        cls.language_code = bot_info.language_code
        cls.is_premium = bot_info.is_premium
        cls.added_to_attachment_menu = bot_info.added_to_attachment_menu
@@ -85,15 +95,19 @@ class BotInfo:
        cls.can_read_all_group_messages = getattr(bot_info, 'can_read_all_group_messages', None)


-# Функция получения данных о боте
-async def bot_get_info():
-    # Получение информации о боте
+async def bot_get_info() -> dict:
+    """
+    Получает информацию о боте и обновляет данные в классе BotInfo.
+
+    :return: Словарь с данными о боте.
+    """
+    # Получение информации о боте через API
    bot_info_data = await bot.get_me()

    # Обновляем данные о боте в BotInfo
    BotInfo.update(bot_info_data)

-    # Возвращаем обновленные данные
+    # Возвращаем обновленные данные о боте
    return {
        'bot_info': bot_info_data,
        'id': bot_info_data.id,
@@ -101,7 +115,7 @@ async def bot_get_info():
        'last_name': bot_info_data.last_name,
        'username': bot_info_data.username,
        'description': getattr(bot_info_data, 'description', ''),
-        'short_description': getattr(bot_info_data, 'description', ''),
+        'short_description': getattr(bot_info_data, 'short_description', ''),
        'language_code': bot_info_data.language_code,
        'prefix': BotVar.prefix,
        'is_premium': bot_info_data.is_premium,
--- a/BotLibrary/system/directory.py
+++ b/BotLibrary/system/directory.py
@@ -3,12 +3,19 @@

 import os
 from ProjectsFiles import ProjectPath, TypeDirectory
+from typing import List

 # Настройка экспорта из модуля
 __all__ = ("create_directories", "setup_directories")

-# Функция создания пустых директорий
-async def create_directories(base_directory, subdirectories):
+
+async def create_directories(base_directory: str, subdirectories: List[str]) -> None:
+    """
+    Создает указанные поддиректории в указанной базовой директории, если они еще не существуют.
+
+    :param base_directory: Путь к базовой директории.
+    :param subdirectories: Список поддиректорий, которые необходимо создать.
+    """
    # Создание директорий и файлов в каждой из них
    for subdirectory in subdirectories:
        directory_path = os.path.join(base_directory, subdirectory)
@@ -16,11 +23,17 @@ async def create_directories(base_directory, subdirectories):
        # Проверка, существует ли директория, если нет - создаём
        if not os.path.exists(directory_path):
            os.makedirs(directory_path)
+            print(f"Создана директория: {directory_path}")


-# Начальная установка пустых директорий
-async def setup_directories():
+async def setup_directories() -> None:
+    """
+    Настройка начальных пустых директорий для проекта.
+    """
+    # Создание директорий для медиа файлов
    await create_directories(ProjectPath.personal_media, TypeDirectory.media_directories)
+
+    # Раскомментируйте следующие строки, если необходимо создать другие директории
    # await create_directories(ProjectPath.received_media, TypeDirectory.media_directories)
    # await create_directories(ProjectPath.bot_files, TypeDirectory.avatar_directories)
-    # await create_directories(ProjectPath.msg, TypeDirectory.msg_directories)
+    # await create_directories(ProjectPath.msg, TypeDirectory.msg_directories)