edu-rdm-integration 3.18.3__tar.gz → 3.18.5__tar.gz

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/CHANGELOG.md

@@ -29,6 +29,62 @@
 ### Удалено
 
 
+## [3.18.5] - 2025-09-19
+
+Добавлена возможность отключения зачистки устаревших данных моделей РВД.
+
+Добавлены новые настройки
+
+| Название настройки в settings           | Описание                                         | Значение по умолчанию |
+|-----------------------------------------|--------------------------------------------------|-----------------------|
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA | Включение зачистки устаревших данных моделей РВД | False                 |
+
+В settings.py:
+
+- Добавить значение по умолчанию:
+  ```
+    PROJECT_DEFAULT_CONFIG.update({
+        ...
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
+        ...
+    })
+  ```
+
+- Получить значение настройки из конфигурационного файла:
+  ```
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
+  ```
+  
+В дефолтный конфиг проекта необходимо добавить:
+
+  ```
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
+  ```
+
+### Добавлено
+
+- [EDUSCHL-23942](https://jira.bars.group/browse/EDUSCHL-23942)
+  PATCH Добавлена возможность отключения зачистки устаревших данных моделей РВД.
+
+
+## [3.18.4] - 2025-09-16
+
+Добавлены параметры `safe` и `log_sql` в команду `rdm_cleanup_outdated_data` для запуска команды в безопасном режиме 
+без выполнения запросов в БД и логирования формируемых sql-запросов.
+
+### Добавлено
+
+- [EDUSCHL-23942](https://jira.bars.group/browse/EDUSCHL-23942)
+  PATCH Добавлена возможность запуска команды `rdm_cleanup_outdated_data` в безопасном режиме.
+
+- [EDUSCHL-23942](https://jira.bars.group/browse/EDUSCHL-23942)
+  PATCH Добавлена возможность запуска команды `rdm_cleanup_outdated_data` с логированием формируемых sql-запросов.
+
+
 ## [3.18.3] - 2025-09-15
 
 Добавлена возможность указания модели РВД для зачистки устаревших данных. Потребовалось при тестировании функционала.
@@ -54,6 +110,9 @@
 
 Доработки модели перечисления RDMModelEnum для расширения функционала механизма зачистки устаревших данных моделей РВД.
 
+У всех моделей РВД, которые являются основными для сущности необходимо заменить базовый класс на 
+`edu_rdm_integration.rdm_models.models.BaseMainRDMModel`.
+
 ### Добавлено
 
 - [EDUDEVOPS-94](https://jira.bars.group/browse/EDUDEVOPS-94)

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edu-rdm-integration
-Version: 3.18.3
+Version: 3.18.5
 Summary: Интеграция с Региональной витриной данных
 Author-email: BARS Group <education_dev@bars.group>
 Project-URL: Homepage, https://stash.bars-open.ru/projects/EDUBASE/repos/edu-rdm-integration/browse
@@ -197,6 +197,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -309,6 +310,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -368,6 +372,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -463,6 +468,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.
 

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/README.md

@@ -149,6 +149,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -261,6 +262,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -320,6 +324,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -415,6 +420,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.
 

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/src/edu_rdm_integration/core/utils.py

@@ -11,9 +11,6 @@ from typing import (
     Union,
 )
 
-from _operator import (
-    attrgetter,
-)
 from django.conf import (
     settings,
 )
@@ -58,7 +55,6 @@ def register_classes(classes: Iterable[type[BaseEnumRegisterMixin]]) -> None:
     Args:
         classes: Классы, поддерживающие интерфейс регистрации.
     """
-
     for enum_class in classes:
         enum_class.register()
 

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/src/edu_rdm_integration/pipelines/cleanup_outdated_data/management/commands/rdm_cleanup_outdated_data.py

@@ -1,3 +1,6 @@
+from django.conf import (
+    settings,
+)
 from django.core.management import (
     BaseCommand,
 )
@@ -18,6 +21,7 @@ class Command(BaseCommand):
     help = 'Ночная команда для очистки устаревших данных РВД.'
 
     def add_arguments(self, parser):
+        """Добавляет аргументы командной строки."""
         models = ', '.join(f'{key} - {value.title}' for key, value in RDMModelEnum.get_enum_data().items())
         models_help_text = (
             f'Значением параметра является перечисление моделей РВД, для которых должна быть произведена зачистка '
@@ -33,7 +37,32 @@ class Command(BaseCommand):
             help=models_help_text,
         )
 
+        parser.add_argument(
+            '--safe',
+            action='store_true',
+            dest='safe',
+            default=False,
+            help='Запускать команду в безопасном режиме (без удаления данных, только логирование).',
+        )
+
+        parser.add_argument(
+            '--log-sql',
+            action='store_true',
+            dest='log_sql',
+            default=False,
+            help='Включить логирование SQL-запросов, выполняемых во время работы команды.',
+        )
+
+    def _cleanup_model_outdated_data(self, options):
+        """Очистка устаревших данных моделей РВД."""
+        model_data_cleaner_manager = ModelOutdatedDataCleanerManager(
+            models=options['models'],
+            safe=options['safe'],
+            log_sql=options['log_sql'],
+        )
+        model_data_cleaner_manager.run()
+
     def handle(self, *args, **options):
         """Запуск очистки устаревших данных РВД."""
-        model_data_cleaner_manager = ModelOutdatedDataCleanerManager(models=options['models'])
-        model_data_cleaner_manager.run()
+        if settings.RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA:
+            self._cleanup_model_outdated_data(options)

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/src/edu_rdm_integration/stages/service/model_outdated_data/cleaners.py

@@ -16,8 +16,17 @@ if TYPE_CHECKING:
 class BaseModelOutdatedDataCleaner(metaclass=ABCMeta):
     """Базовый класс уборщика устаревших данных моделей РВД."""
 
-    def __init__(self, model_enum_value: 'ModelEnumValue', *args, **kwargs):
+    def __init__(
+        self,
+        model_enum_value: 'ModelEnumValue',
+        *args,
+        safe: bool = False,
+        log_sql: bool = False,
+        **kwargs,
+    ):
         self._model_enum_value = model_enum_value
+        self._safe = safe
+        self._log_sql = log_sql
 
         super().__init__(*args, **kwargs)
 

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/src/edu_rdm_integration/stages/service/model_outdated_data/managers.py

@@ -23,8 +23,17 @@ class ModelOutdatedDataCleanerManager:
     метод run.
     """
 
-    def __init__(self, *args, models: Optional[list[str]] = None, **kwargs):
+    def __init__(
+        self,
+        *args,
+        models: Optional[list[str]] = None,
+        safe: bool = False,
+        log_sql: bool = False,
+        **kwargs,
+    ):
         self._models = models
+        self._safe = safe
+        self._log_sql = log_sql
 
         super().__init__(*args, **kwargs)
 
@@ -39,7 +48,7 @@ class ModelOutdatedDataCleanerManager:
                 outdated_data_cleaner_module = importlib.import_module(outdated_data_cleaner_module_path)
                 outdated_data_cleaner = getattr(outdated_data_cleaner_module, cleaner_name)
 
-            outdated_data_cleaner(model_enum_value=model_enum_value).run()
+            outdated_data_cleaner(model_enum_value=model_enum_value, safe=self._safe, log_sql=self._log_sql).run()
 
     def _process_models(self):
         """Обрабатывает все модели РВД."""

{edu_rdm_integration-3.18.3 → edu_rdm_integration-3.18.5}/src/edu_rdm_integration.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: edu-rdm-integration
-Version: 3.18.3
+Version: 3.18.5
 Summary: Интеграция с Региональной витриной данных
 Author-email: BARS Group <education_dev@bars.group>
 Project-URL: Homepage, https://stash.bars-open.ru/projects/EDUBASE/repos/edu-rdm-integration/browse
@@ -197,6 +197,7 @@ INSTALLED_APPS = (
         ('uploader_client', 'ORGANIZATION_OGRN'): '',
         ('uploader_client', 'INSTALLATION_NAME'): '',
         ('uploader_client', 'INSTALLATION_ID'): '',
+        ('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA'): False,
     })  
     ```
 - Получение значений настроек из конфигурационного файла в settings.py:
@@ -309,6 +310,9 @@ INSTALLED_APPS = (
     # Директория логов отправки данных в витрину, доступных для скачивания
     RDM_UPLOAD_LOG_DIR = os.path.join('logs', 'rdm', 'upload')
     os.makedirs(os.path.join(MEDIA_ROOT, RDM_UPLOAD_LOG_DIR), exist_ok=True)
+  
+    # Включить зачистку устаревших данных моделей РВД
+    RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA = conf.get_bool('rdm_cleanup_outdated_data', 'ENABLE_CLEANUP_MODELS_OUTDATED_DATA')
     ```
 
 Перечень настроек в settings.py указан в таблице ниже.
@@ -368,6 +372,7 @@ INSTALLED_APPS = (
 | RDM_COLLECT_LOG_DIR                          | Директория логов сбора данных, доступных для скачивания                                                                            |                         |
 | RDM_EXPORT_LOG_DIR                           | Директория логов экспорта данных, доступных для скачивания                                                                         |                         |
 | RDM_UPLOAD_LOG_DIR                           | Директория логов отправки данных в витрину, доступных для скачивания                                                               |                         |
+| RDM_ENABLE_CLEANUP_MODELS_OUTDATED_DATA      | Включение зачистки устаревших данных моделей РВД                                                                                   | False                   |
 
 - В дефолтный конфиг проекта необходимо добавить:
 
@@ -463,6 +468,11 @@ INSTALLED_APPS = (
     INSTALLATION_NAME =
     # Идентификатор инсталляции в целевой Витрине
     INSTALLATION_ID =
+    
+    # Настройка зачистки устаревших данных
+    [rdm_cleanup_outdated_data]
+    # Включить зачистку устаревших данных моделей РВД
+    ENABLE_CLEANUP_MODELS_OUTDATED_DATA = False
     ```
 На основе дефолтного конфига произвести конфигурирование приложений.