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

educommon/contingent/catalogs.py

@@ -863,8 +863,7 @@ class IdentityDocumentsTypes(BaseEnumerate):
 
     @classmethod
     def __append_to_result(cls, item, result):
-        """
-        Добавляет значения к результирующему списку.
+        """Добавляет значения к результирующему списку.
 
         :param item: tuple, например (ключ1, ("значение", УФТТ код))
         :param result: [(key1, value1), (key2, value2), .. (keyN, valueN)]
@@ -890,29 +889,45 @@ class AdaptationType(BaseEnumerate):
     RETARDED_HARD = 210
     OTHER = 211
     AUTISTIC_DISORDER = 212
+    HEARING_IMPAIRED = 213
+    MENTAL_RETARDATION = 214
 
     values = {
-        HALF_BLIND: "для слабовидящих обучающихся",
-        BLIND: "для слепых обучающихся",
-        HALF_DEAF: "для слабослышащих",
-        DEAF: "для глухих",
+        HALF_BLIND: 'Для слабовидящих детей',
+        BLIND: 'Для слепых детей',
+        HALF_DEAF: 'Для слабослышащих',
+        DEAF: 'Для глухих детей',
         HALF_DEAF_HARD:
-            "для слабослышащих обучающихся, имеющих сложную структуру "
-            "дефекта (нарушение слуха и задержка психического развития)",
-        WEAK:
-            "для обучающихся, имеющих нарушения опорно-двигательного "
-            "аппарата",
-        SPEECH_PATHOLOGY: "для обучающихся, имеющих тяжелые нарушения речи",
-        DELAYED: "для обучающихся с задержкой психического развития",
-        RETARDED: "для обучающихся с умственной отсталостью",
-        RETARDED_HARD:
-            "для обучающихся с умственной отсталостью, имеющих сложную "
-            "структуру дефекта",
-        OTHER: "для обучающихся с иными ограничениями здоровья",
-        AUTISTIC_DISORDER:
-            "для обучающихся с расстройствами аутистического спектра",
+            'Для слабослышащих обучающихся, имеющих сложную структуру '
+            'дефекта (нарушение слуха и задержка психического развития)',
+        WEAK: 'Для детей с нарушениями опорно-двигательного аппарата',
+        SPEECH_PATHOLOGY: 'Для детей с тяжёлыми нарушениями речи',
+        DELAYED: 'Для детей с задержкой психического развития',
+        RETARDED: 'Для обучающихся с умственной отсталостью',
+        RETARDED_HARD: 'Для обучающихся с умственной отсталостью, имеющих сложную структуру дефекта',
+        OTHER: 'Для обучающихся с иными ограничениями здоровья',
+        AUTISTIC_DISORDER: 'Для детей с расстройством аутистического спектра',
+        HEARING_IMPAIRED: 'Для слабослышащих и позднооглохших детей',
+        MENTAL_RETARDATION: 'Для детей с умственной отсталостью, нарушением интеллекта',
+    }
+
+    epgu_codes = {
+        DEAF: 1,
+        HEARING_IMPAIRED: 2,
+        BLIND: 3,
+        HALF_BLIND: 4,
+        SPEECH_PATHOLOGY: 5,
+        WEAK: 6,
+        DELAYED: 7,
+        AUTISTIC_DISORDER: 8,
+        MENTAL_RETARDATION: 9,
     }
 
+    @classmethod
+    def get_epgu_code(cls, adaptation_type):
+        """Возвращает код ЕПГУ для заданного типа адаптации, если он существует."""
+        return cls.epgu_codes.get(adaptation_type)
+
 
 class TypeTrainingLongTermTreatment(BaseEnumerate):
     """Справочник "Виды обучения при длительном лечении"."""

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.11.3
-VERSION = 3.11.3
-REVISION = 2089fc2335f9595dd14f5fbfc289461e2f039ea4
-VERSION_DATE = 06.03.2025
-REVISION_DATE = 06.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.11.3.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.11.3
+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.11.3.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=FVl_Zvkg_h4v6tRzMgBy4P7k_tR6yE9hEJg5ZrK1TWg,450
+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
@@ -120,7 +120,7 @@ educommon/contingent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 educommon/contingent/actions.py,sha256=zcKKUvpWJrm32q0q96oILqVIWMaqaO8T3_sbu0Z6KO0,3233
 educommon/contingent/app_meta.py,sha256=4VE-PqRFLs8vLkaowIHbDyVb_9dvCScml3WvZ24KDws,273
 educommon/contingent/base.py,sha256=pGpYqTuJ9XyKpK7PKZZAngURlb7-YQx-wCZKAhYhYQA,6854
-educommon/contingent/catalogs.py,sha256=OafO1jDi7q7wm_7cnu8k-xiUc6mwKhXE36HklJX2Sb4,61449
+educommon/contingent/catalogs.py,sha256=tUQSjDF0oWD4I7SUF48PwFg0tZbtQP5tUiWtR6zyY7Q,62092
 educommon/contingent/contingent_plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 educommon/contingent/contingent_plugin/actions.py,sha256=SXjFCDGyFHrOZNcroEouRLZB7NqFSs7M_1Gw89bfe48,717
 educommon/contingent/contingent_plugin/apps.py,sha256=2RustoCdwosXEIXpXlgK1UVfFvx729K_lP6F6l8xCr8,810
@@ -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.11.3.dist-info/METADATA,sha256=04IPpdzNeAVXE9Yh8UaFlMp6KdM7KMw9TDqyP4wGrUY,1666
-educommon-3.11.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-educommon-3.11.3.dist-info/dependency_links.txt,sha256=RNlr4t-BxZRm7e_IfVo1ikr5ln-7viimzLHvQMO1C_Q,43
-educommon-3.11.3.dist-info/top_level.txt,sha256=z5fbW7bz_0V1foUm_FGcZ9_MTpW3N1dBN7-kEmMowl4,10
-educommon-3.11.3.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.11.3.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