educommon 3.12.0__tar.gz → 3.13.0__tar.gz

{educommon-3.12.0/src/educommon.egg-info → educommon-3.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: educommon
-Version: 3.12.0
+Version: 3.13.0
 Summary: Общая кодовая база для проектов БЦ Образование
 Home-page: https://stash.bars-open.ru/projects/EDUBASE/repos/educommon
 Author: BARS Group
@@ -12,8 +12,6 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Framework :: Django :: 2.2
 Classifier: Framework :: Django :: 3.0

{educommon-3.12.0 → educommon-3.13.0}/setup.py

@@ -30,8 +30,6 @@ def main():
             'Operating System :: OS Independent',
             'Development Status :: 5 - Production/Stable',
             'Programming Language :: Python',
-            'Programming Language :: Python :: 3.7',
-            'Programming Language :: Python :: 3.8',
             'Programming Language :: Python :: 3.9',
             'Framework :: Django :: 2.2',
             'Framework :: Django :: 3.0',

educommon-3.13.0/src/educommon/django/db/signals.py

@@ -0,0 +1,152 @@
+from typing import (
+    Callable,
+    Optional,
+)
+
+from django.db.models import (
+    Model,
+)
+from django.dispatch.dispatcher import (
+    Signal,
+)
+from educommon import (
+    logger,
+)
+
+
+class BaseBeforeMigrateHandler:
+    """
+    Базовый обработчик сигнала before_handle_migrate_signal.
+
+    Должен быть унаследован и инстанс наследника регистрироваться
+    как обработчик сигнала.
+    """
+
+    def _is_accessing_non_migrating_databases(self, migrating_database: str) -> bool:
+        for model_cls in self._get_working_models():
+            db = self._get_model_db(model_cls)
+            if db != migrating_database:
+                return True
+
+        return False
+
+    def _get_model_db(self, model_cls: type[Model]) -> str:
+        """
+        Возвращает псевдоним базы данных, к которой пойдет запрос
+        по данной модели.
+        """
+
+        return model_cls.objects.all().db
+
+    def _get_migrating_database(self, sender) -> str:
+        """Возвращает псевдоним базы данных, с которой работает миграция."""
+
+        return sender.database
+
+    def _get_working_models(self) -> set[type[Model]]:
+        """Модели, с которым будет работать обработчик сигнала."""
+
+        raise NotImplementedError()
+
+    def handler(self, sender, *args, **kwargs):
+        """Непосредственный обработчик сигнала."""
+
+        raise NotImplementedError()
+
+    def __call__(self, sender, *args, **kwargs):
+        migrating_database = self._get_migrating_database(sender)
+        if self._is_accessing_non_migrating_databases(migrating_database):
+            logger.warning('Предотвращена попытка доступа к базе данных, по которой не производится миграция')
+            return
+
+        return self.handler(sender, *args, **kwargs)
+
+
+class BaseAfterMigrateHandler:
+    """
+    Базовый обработчик сигнала after_handle_migrate_signal.
+
+    Должен быть унаследован и инстанс наследника регистрироваться
+    как обработчик сигнала.
+    """
+
+    def _is_accessing_non_migrating_databases(self, migrating_database: str) -> bool:
+        for model_cls in self._get_working_models():
+            db = self._get_model_db(model_cls)
+            if db != migrating_database:
+                return True
+
+        return False
+
+    def _get_model_db(self, model_cls: type[Model]) -> str:
+        """
+        Возвращает псевдоним базы данных, к которой пойдет запрос
+        по данной модели.
+        """
+
+        return model_cls.objects.all().db
+
+    def _get_migrating_database(self, sender) -> str:
+        """Возвращает псевдоним базы данных, с которой работает миграция."""
+
+        return sender.database
+
+    def _get_working_models(self) -> set[type[Model]]:
+        """Модели, с которым будет работать обработчик сигнала."""
+
+        raise NotImplementedError()
+
+    def handler(self, sender, *args, **kwargs):
+        """Непосредственный обработчик сигнала."""
+
+        raise NotImplementedError()
+
+    def __call__(self, sender, *args, **kwargs):
+        migrating_database = self._get_migrating_database(sender)
+        if self._is_accessing_non_migrating_databases(migrating_database):
+            logger.warning('Предотвращена попытка доступа к базе данных, по которой не производится миграция')
+            return
+
+        return self.handler(sender, *args, **kwargs)
+
+
+class BeforeHandleMigrateSignal(Signal):
+    _handler_base_class = BaseBeforeMigrateHandler
+
+    def connect(
+        self,
+        receiver: Callable,
+        sender: Optional = None,
+        weak: bool = True,
+        dispatch_uid: Optional[str] = None,
+    ) -> None:
+        if not isinstance(receiver, self._handler_base_class):
+            logger.warning(
+                f'Обработчик сигнала before_handle_migrate_signal {receiver} не зарегистрирован, поскольку '
+                f'он не является подклассом {self._handler_base_class.__name__}'
+            )
+
+        return super().connect(receiver, sender, weak, dispatch_uid)
+
+
+class AfterHandleMigrateSignal(Signal):
+    _handler_base_class = BaseBeforeMigrateHandler
+
+    def connect(
+        self,
+        receiver: Callable,
+        sender: Optional = None,
+        weak: bool = True,
+        dispatch_uid: Optional[str] = None,
+    ) -> None:
+        if not isinstance(receiver, self._handler_base_class):
+            logger.warning(
+                f'Обработчик сигнала after_handle_migrate_signal {receiver} не зарегистрирован, поскольку '
+                f'он не является подклассом {self._handler_base_class.__name__}'
+            )
+
+        return super().connect(receiver, sender, weak, dispatch_uid)
+
+
+before_handle_migrate_signal = BeforeHandleMigrateSignal()
+after_handle_migrate_signal = AfterHandleMigrateSignal()

{educommon-3.12.0 → educommon-3.13.0}/src/educommon/version.conf

@@ -4,8 +4,8 @@
 # нормальной установки обновлений.
 
 [version]
-BRANCH = tags/3.12.0^0
-VERSION = 3.12.0
-REVISION = 77c8293bb54ede8a5d5f06d376cf771c28cada88
-VERSION_DATE = 11.03.2025
-REVISION_DATE = 11.03.2025
+BRANCH = tags/3.13.0
+VERSION = 3.13.0
+REVISION = 63072e48f15fed47a1f135ca1fe0e9bf3589c120
+VERSION_DATE = 27.03.2025
+REVISION_DATE = 27.03.2025

{educommon-3.12.0 → educommon-3.13.0/src/educommon.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: educommon
-Version: 3.12.0
+Version: 3.13.0
 Summary: Общая кодовая база для проектов БЦ Образование
 Home-page: https://stash.bars-open.ru/projects/EDUBASE/repos/educommon
 Author: BARS Group
@@ -12,8 +12,6 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Framework :: Django :: 2.2
 Classifier: Framework :: Django :: 3.0

educommon-3.12.0/src/educommon/django/db/signals.py

@@ -1,7 +0,0 @@
-from django.dispatch.dispatcher import (
-    Signal,
-)
-
-
-before_handle_migrate_signal = Signal()
-after_handle_migrate_signal = Signal()