educommon 3.12.0__py3-none-any.whl → 3.13.0__py3-none-any.whl

educommon/django/db/signals.py

@@ -1,7 +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 = Signal()
-after_handle_migrate_signal = Signal()
+before_handle_migrate_signal = BeforeHandleMigrateSignal()
+after_handle_migrate_signal = AfterHandleMigrateSignal()

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.dist-info → educommon-3.13.0.dist-info}/METADATA

@@ -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.dist-info → educommon-3.13.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 educommon/__init__.py,sha256=fvsBDL7g8HgOTd-JHOh7TSvMcnUauvGVgPuyA2Z9hUI,419
 educommon/thread_data.py,sha256=n0XtdesP9H92O3rJ8K6fVnJLiHqyJEfh2xpuT36wzxs,61
-educommon/version.conf,sha256=xen1bzwhKoQ5lIF3Nb7Dd54xD8sqWUWN5HjzGA8el-c,452
+educommon/version.conf,sha256=0lvGb_lFBCjDdceu6N0siB06AZLkq9Q5dViDH4XYISQ,450
 educommon/about/README.rst,sha256=U48UW5jv-8qHyaV56atzzkNMvzHKXVcWSb_NR06PnMo,2685
 educommon/about/__init__.py,sha256=H1W0IgW-qX9LCZ49GOJzHdmQGHhh-MA6U1xmNx7WnfM,132
 educommon/about/apps.py,sha256=GrpJAOE2sF0ukWsqugP_WJS88DO4aL-T3kTLprrJrcA,259
@@ -142,7 +142,7 @@ educommon/django/db/fields.py,sha256=a_CCuDthg9Gv_T3Ngm93Iz6kTFNo1LJMnk2-PFKohsM
 educommon/django/db/models.py,sha256=mNtrj3MZYCXJJ2alw5TaIiN_fFjsCUrm8OCeuZ9isWI,2107
 educommon/django/db/observer.py,sha256=oAh0Uu0fwlGZ4pj1ytKZyAhosbWKs4THGBTVyR4NYmA,10990
 educommon/django/db/routers.py,sha256=Zx8cIf7ZQpQLVhxutNj31_IQqYS6J3MnuBTOA5m43SQ,3268
-educommon/django/db/signals.py,sha256=pbBr31q3hK6aBW6FZXYmATxKp8KrCuqmrNdDZNnpw38,136
+educommon/django/db/signals.py,sha256=XADIWMLtoAEgHX74yBw8nrHhbePQxmwBdpgw0PwN1F0,5511
 educommon/django/db/utils.py,sha256=S9rZhfLn4GYWXiVOPSsEGl382NzUFeOxh-G7OtB43vE,9206
 educommon/django/db/migration/__init__.py,sha256=FwICNxrFGFwzy5klIKzYIhVpsunLipS4W8ysS8C0z5k,1882
 educommon/django/db/migration/operations.py,sha256=R_SCK8R1IF6x5qjJPoTnGjiAedqnBT-OpaEjyyJaxVM,9527
@@ -350,8 +350,8 @@ educommon/ws_log/smev/exceptions.py,sha256=lmy7o2T3dJkqgIhG07qyh5yPqO3qZAYABuT4J
 educommon/ws_log/templates/report/smev_logs.xlsx,sha256=nnYgB0Z_ix8HoxsRICjsZfFRQBdra-5Gd8nWhCxTjYg,10439
 educommon/ws_log/templates/ui-js/smev-logs-list-window.js,sha256=AGup3D8GTJSY9WdDPj0zBJeYQBFOmGgcbxPOJbKK-nY,513
 educommon/ws_log/templates/ui-js/smev-logs-report-setting-window.js,sha256=nQ7QYK9frJcE7g7kIt6INg9TlEEJAPPayBJgRaoTePA,1103
-educommon-3.12.0.dist-info/METADATA,sha256=9t7lbgOOSfePEfKP9Tbsenc-NLJ06Tk4ALb3WoUe5Ag,1666
-educommon-3.12.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-educommon-3.12.0.dist-info/dependency_links.txt,sha256=RNlr4t-BxZRm7e_IfVo1ikr5ln-7viimzLHvQMO1C_Q,43
-educommon-3.12.0.dist-info/top_level.txt,sha256=z5fbW7bz_0V1foUm_FGcZ9_MTpW3N1dBN7-kEmMowl4,10
-educommon-3.12.0.dist-info/RECORD,,
+educommon-3.13.0.dist-info/METADATA,sha256=_zlgm_31M00zT6LvfzhGekdF9S6_2bNQxlxiFq5eleI,1566
+educommon-3.13.0.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+educommon-3.13.0.dist-info/dependency_links.txt,sha256=RNlr4t-BxZRm7e_IfVo1ikr5ln-7viimzLHvQMO1C_Q,43
+educommon-3.13.0.dist-info/top_level.txt,sha256=z5fbW7bz_0V1foUm_FGcZ9_MTpW3N1dBN7-kEmMowl4,10
+educommon-3.13.0.dist-info/RECORD,,

{educommon-3.12.0.dist-info → educommon-3.13.0.dist-info}/WHEEL

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