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

educommon/__init__.py

@@ -1,6 +1,5 @@
 """Общая кодовая база для проектов БЦ Образование."""
 
-
 #: Неопределенное значение.
 #:
 #: Может использоваться в т.ч. как значение аргументов по умолчанию, когда есть

educommon/about/ui/actions.py

@@ -48,21 +48,13 @@ class Package(VirtualModel):
 
     @classmethod
     def _get_ids(cls):
-        packages = sorted(
-            tuple(get_installed_distributions()),
-            key=lambda p: p.project_name
-        )
+        packages = sorted(tuple(get_installed_distributions()), key=lambda p: p.project_name)
 
         for row_id, package in enumerate(packages, 1):
-            yield dict(
-                id=row_id,
-                name=package.project_name,
-                version=package.version
-            )
+            yield dict(id=row_id, name=package.project_name, version=package.version)
 
 
 class PackagesPack(ObjectPack):
-
     """Пак грида установленных в системе пакетов."""
 
     model = Package
@@ -85,11 +77,12 @@ class PackagesPack(ObjectPack):
             header='Версия',
         ),
     )
+
+
 # -----------------------------------------------------------------------------
 
 
 class PostgreSQLExtension(VirtualModel):
-
     """Виртуальная модель 'Расширение PostgreSQL'."""
 
     def __init__(self, data):
@@ -116,7 +109,6 @@ class PostgreSQLExtension(VirtualModel):
 
 
 class PostgreSQLExtensionsPack(ObjectPack):
-
     """Пак грида расширений БД."""
 
     model = PostgreSQLExtension
@@ -141,11 +133,12 @@ class PostgreSQLExtensionsPack(ObjectPack):
             width=1,
         ),
     )
+
+
 # -----------------------------------------------------------------------------
 
 
 class AboutPack(BasePack, metaclass=ABCMeta):
-
     """Пак окна 'Информация о системе'."""
 
     title = 'О системе'
@@ -165,10 +158,12 @@ class AboutPack(BasePack, metaclass=ABCMeta):
 
         self.packages_pack = PackagesPack()
         self.postgresql_extensions_pack = PostgreSQLExtensionsPack()
-        self.subpacks.extend((
-            self.packages_pack,
-            self.postgresql_extensions_pack,
-        ))
+        self.subpacks.extend(
+            (
+                self.packages_pack,
+                self.postgresql_extensions_pack,
+            )
+        )
 
     @abstractmethod
     def get_version_config_path(self):
@@ -183,15 +178,10 @@ class AboutPack(BasePack, metaclass=ABCMeta):
         - настройки состава вкладок;
         - интеграции с системой прав доступа проекта.
         """
-        return dict(
-            can_view_common_tab=True,
-            can_view_packages_tab=True,
-            can_view_postgresql_ext_tab=True
-        )
+        return dict(can_view_common_tab=True, can_view_packages_tab=True, can_view_postgresql_ext_tab=True)
 
 
 class AboutWindowAction(BaseWindowAction):
-
     """Экшен окна 'Информация о системе'."""
 
     def create_window(self):
@@ -199,17 +189,13 @@ class AboutWindowAction(BaseWindowAction):
 
     def set_window_params(self):
         self.win_params['data'] = dict(
-            version=get_build_info(self.parent.get_version_config_path()),
-            project_title=self.parent.project_title
+            version=get_build_info(self.parent.get_version_config_path()), project_title=self.parent.project_title
         )
         self.win_params['version_info'] = (
             (1, 'OC', get_os_version()),
             (2, 'Python', python_version()),
-            (3, 'PostgreSQL', '.'.join(
-                map(str, get_postgresql_version(connection))
-            )),
+            (3, 'PostgreSQL', '.'.join(map(str, get_postgresql_version(connection)))),
         )
-        tab_permissions = self.parent.get_tab_permissions(
-            self.request, self.context)
+        tab_permissions = self.parent.get_tab_permissions(self.request, self.context)
 
         self.win_params.update(tab_permissions)

educommon/about/ui/ui.py

@@ -24,7 +24,6 @@ from educommon.utils.ui import (
 
 
 class CommonTab(WindowTab):
-
     """Вкладка с общей информацией о системе."""
 
     title = 'Общие сведения'
@@ -48,7 +47,6 @@ class CommonTab(WindowTab):
 
 
 class PackagesTab(ObjectGridTab):
-
     """Вкладка со списком пакетов, установленных в системе."""
 
     title = 'Версии ПО'
@@ -108,7 +106,6 @@ class PackagesTab(ObjectGridTab):
 
 
 class PostgreSQLExtensionsTab(ObjectGridTab):
-
     """Вкладка со списком расширений PostgreSQL."""
 
     title = 'Расширения БД'
@@ -127,7 +124,6 @@ class PostgreSQLExtensionsTab(ObjectGridTab):
 
 
 class AboutWindow(TabbedWindow):
-
     """Окно 'Информация о системе'."""
 
     tabs = (
@@ -151,14 +147,10 @@ class AboutWindow(TabbedWindow):
                 available_tab_titles.append(tab.title)
 
         # удаление вкладок
-        self.tabs[:] = (
-            tab for tab in self.tabs
-            if tab.title in available_tab_titles
-        )
+        self.tabs[:] = (tab for tab in self.tabs if tab.title in available_tab_titles)
         # удаление контейнеров вкладок
         self._tab_container.items[:] = (
-            item for item in self._tab_container.items
-            if item.title in available_tab_titles
+            item for item in self._tab_container.items if item.title in available_tab_titles
         )
 
     def set_params(self, params):
@@ -176,8 +168,7 @@ class AboutWindow(TabbedWindow):
         if len(self._tab_container.items) > 1:
             for tab in self._tab_container.items:
                 if hasattr(tab, 'grid'):
-                    self.lazy_grids.setdefault(
-                        tab.client_id, []).append(tab.grid.client_id)
+                    self.lazy_grids.setdefault(tab.client_id, []).append(tab.grid.client_id)
                     tab.grid.store.auto_load = False
 
         self.template_globals = local_template('about-window.js')

educommon/about/utils.py

@@ -14,12 +14,13 @@ def get_installed_distributions():
 
     :rtype: list of :class:`~pkg_resources.Distribution`.
     """
-    stdlib_pkgs = ('python', 'wsgiref', 'argparse',)
+    stdlib_pkgs = (
+        'python',
+        'wsgiref',
+        'argparse',
+    )
 
     # pylint: disable=not-an-iterable
     for dist in working_set:
-        if (
-            dist.key not in stdlib_pkgs and
-            normcase(realpath(dist.location)).startswith(realpath(sys.prefix))
-        ):
+        if dist.key not in stdlib_pkgs and normcase(realpath(dist.location)).startswith(realpath(sys.prefix)):
             yield dist

educommon/async_task/__init__.py

@@ -1,4 +1,3 @@
 """Реестр "Асинхронные задачи"."""
 
-
 default_app_config = __name__ + '.apps.AppConfig'

educommon/async_task/actions.py

@@ -1,11 +1,13 @@
 from functools import (
     partial,
 )
+
 from typing import (
     Any,
     Dict,
     List,
     Optional,
+    TYPE_CHECKING,
 )
 
 from django.core.exceptions import (
@@ -44,6 +46,11 @@ from educommon.utils.ui import (
     ChoicesFilter,
 )
 
+if TYPE_CHECKING:
+    from django.db.models.query import (
+        QuerySet,
+    )
+
 
 class AsyncTaskPack(ObjectPack):
     """Пак асинхронных задач."""
@@ -79,7 +86,7 @@ class AsyncTaskPack(ObjectPack):
             'header': 'Тип задачи',
             'width': 5,
             'sortable': True,
-            'sort_fields': ('task_type_id', ),
+            'sort_fields': ('task_type_id',),
             'filter': ChoicesFilter(
                 choices=[(value.key, value.title) for value in AsyncTaskType.get_model_enum_values()],
                 parser=str,
@@ -103,7 +110,7 @@ class AsyncTaskPack(ObjectPack):
             'header': 'Статус задачи',
             'width': 5,
             'sortable': True,
-            'sort_fields': ('status_id', ),
+            'sort_fields': ('status_id',),
             'filter': ChoicesFilter(
                 choices=[(value.key, value.title) for value in AsyncTaskStatus.get_model_enum_values()],
                 parser=str,
@@ -117,10 +124,12 @@ class AsyncTaskPack(ObjectPack):
 
         self.view_result_action = ViewResultWindowAction()
         self.revoke_task_action = RevokeAsyncTaskAction()
-        self.actions.extend((
-            self.view_result_action,
-            self.revoke_task_action,
-        ))
+        self.actions.extend(
+            (
+                self.view_result_action,
+                self.revoke_task_action,
+            )
+        )
 
     def declare_context(self, action):
         """Декларация контекста."""
@@ -192,23 +201,19 @@ class RevokeAsyncTaskAction(BaseAction):
         """Выполнение экшена."""
         running_tasks = self._get_running_tasks(context.async_task_ids.split(','))
         task_id_to_status = {task.id: task.status for task in running_tasks.only('id', 'status')}
-        all_tasks_are_cancellable = all(
-            AsyncTaskStatus.is_cancellable(status) for status in task_id_to_status.values()
-        )
+        all_tasks_are_cancellable = all(AsyncTaskStatus.is_cancellable(status) for status in task_id_to_status.values())
         if not all_tasks_are_cancellable:
             return OperationResult(success=False, message='Необходимо выбрать только те задачи, которые запущены!')
 
         to_revoke_task_ids = [
-            str(task_id)
-            for task_id, status in task_id_to_status.items()
-            if AsyncTaskStatus.is_cancellable(status)
+            str(task_id) for task_id, status in task_id_to_status.items() if AsyncTaskStatus.is_cancellable(status)
         ]
 
         revoke_async_tasks(to_revoke_task_ids)
 
         return OperationResult()
 
-    def _get_running_tasks(self, ids: List[str]) -> 'QuerySet':
+    def _get_running_tasks(self, ids: List[str]) -> 'QuerySet[RunningTask]':
         """Возвращает кварисет асинхронных задач."""
         try:
             running_task_qs = self.parent.model.objects.filter(id__in=ids)

educommon/async_task/apps.py

@@ -4,6 +4,10 @@ from django.apps import (
 
 
 class AppConfig(AppConfigBase):
+    """Конфигурация реестра "Асинхронные задачи".
+
+    Устанавливает имя и метку приложения для регистрации в системе Django.
+    """
 
     name = __package__
     label = 'async_task'

educommon/async_task/locker.py

@@ -54,17 +54,14 @@ class TaskLocker:
     def lock_id(self) -> str:
         """Ключ в кэше."""
         return self.lock_id_format.format(
-            task_name=self.task_name,
-            params='&'.join(f'{k}={v}' for k, v in self.params.items())
+            task_name=self.task_name, params='&'.join(f'{k}={v}' for k, v in self.params.items())
         )
 
     def acquire_lock(self) -> str:
         """Установка блокировки."""
         value = self.task_id or self.DEFAULT_LOCK_VALUE
         cache.set(self.lock_id, value, self.expire_on)
-        self.debug(
-            f'Lock acquired for Task {self.task_name} ({self.params}) with value: {value}'
-        )
+        self.debug(f'Lock acquired for Task {self.task_name} ({self.params}) with value: {value}')
 
         return self.lock_id
 

educommon/async_task/migrations/0001_initial.py

@@ -9,7 +9,6 @@ from django.db import (
 
 
 class Migration(migrations.Migration):
-
     initial = True
 
     dependencies = [
@@ -21,7 +20,12 @@ class Migration(migrations.Migration):
             name='AsyncTaskStatus',
             fields=[
                 ('title', models.TextField(verbose_name='расшифровка значения')),
-                ('key', models.CharField(db_index=True, max_length=512, primary_key=True, serialize=False, verbose_name='ключ')),
+                (
+                    'key',
+                    models.CharField(
+                        db_index=True, max_length=512, primary_key=True, serialize=False, verbose_name='ключ'
+                    ),
+                ),
                 ('order_number', models.PositiveIntegerField(default=100000, verbose_name='Порядковый номер')),
             ],
             options={
@@ -32,7 +36,12 @@ class Migration(migrations.Migration):
             name='AsyncTaskType',
             fields=[
                 ('title', models.TextField(verbose_name='расшифровка значения')),
-                ('key', models.CharField(db_index=True, max_length=512, primary_key=True, serialize=False, verbose_name='ключ')),
+                (
+                    'key',
+                    models.CharField(
+                        db_index=True, max_length=512, primary_key=True, serialize=False, verbose_name='ключ'
+                    ),
+                ),
                 ('order_number', models.PositiveIntegerField(default=100000, verbose_name='Порядковый номер')),
             ],
             options={
@@ -47,13 +56,50 @@ class Migration(migrations.Migration):
                 ('name', models.CharField(blank=True, max_length=512, verbose_name='Наименование задачи')),
                 ('profile_id', models.PositiveIntegerField(blank=True, null=True)),
                 ('description', models.CharField(blank=True, max_length=512, verbose_name='Описание задачи')),
-                ('options', django.contrib.postgres.fields.jsonb.JSONField(blank=True, null=True, verbose_name='Дополнительные опции задачи')),
-                ('queued_at', models.DateTimeField(blank=True, db_index=True, null=True, verbose_name='Дата и время помещения в очередь')),
+                (
+                    'options',
+                    django.contrib.postgres.fields.jsonb.JSONField(
+                        blank=True, null=True, verbose_name='Дополнительные опции задачи'
+                    ),
+                ),
+                (
+                    'queued_at',
+                    models.DateTimeField(
+                        blank=True, db_index=True, null=True, verbose_name='Дата и время помещения в очередь'
+                    ),
+                ),
                 ('started_at', models.DateTimeField(blank=True, null=True, verbose_name='Дата и время запуска задачи')),
-                ('finished_at', models.DateTimeField(blank=True, null=True, verbose_name='Дата и время завершения задачи')),
-                ('profile_type', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='contenttypes.ContentType')),
-                ('status', models.ForeignKey(default='PENDING', on_delete=django.db.models.deletion.PROTECT, to='async_task.AsyncTaskStatus', verbose_name='Состояние задачи')),
-                ('task_type', models.ForeignKey(default='UNKNOWN', on_delete=django.db.models.deletion.PROTECT, to='async_task.AsyncTaskType', verbose_name='Тип задачи')),
+                (
+                    'finished_at',
+                    models.DateTimeField(blank=True, null=True, verbose_name='Дата и время завершения задачи'),
+                ),
+                (
+                    'profile_type',
+                    models.ForeignKey(
+                        blank=True,
+                        null=True,
+                        on_delete=django.db.models.deletion.SET_NULL,
+                        to='contenttypes.ContentType',
+                    ),
+                ),
+                (
+                    'status',
+                    models.ForeignKey(
+                        default='PENDING',
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to='async_task.AsyncTaskStatus',
+                        verbose_name='Состояние задачи',
+                    ),
+                ),
+                (
+                    'task_type',
+                    models.ForeignKey(
+                        default='UNKNOWN',
+                        on_delete=django.db.models.deletion.PROTECT,
+                        to='async_task.AsyncTaskType',
+                        verbose_name='Тип задачи',
+                    ),
+                ),
             ],
             options={
                 'verbose_name': 'Асинхронная задача',

educommon/async_task/migrations/0002_task_type_and_status_data.py

@@ -8,104 +8,109 @@ def init_task_types(apps, schema_editor):
     """Заполнение первоначальными данными AsyncTaskType."""
     AsyncTaskType = apps.get_model('async_task', 'AsyncTaskType')  # noqa: N806
 
-    AsyncTaskType.objects.bulk_create([
-        AsyncTaskType(
-            key='UNKNOWN',
-            title='Неизвестно',
-        ),
-        AsyncTaskType(
-            key='SYSTEM',
-            title='Системная',
-        ),
-        AsyncTaskType(
-            key='REPORT',
-            title='Отчет',
-        ),
-        AsyncTaskType(
-            key='IMPORT',
-            title='Импорт данных',
-        ),
-        AsyncTaskType(
-            key='SCHEDULE_FORMING',
-            title='Формирование расписания',
-        ),
-        AsyncTaskType(
-            key='SCHEDULE_CLEANER',
-            title='Очищение расписания',
-        ),
-        AsyncTaskType(
-            key='SCHEDULE_PATTERN_COPY',
-            title='Копирование шаблона расписания',
-        ),
-        AsyncTaskType(
-            key='ST_PRINTING',
-            title='Печать учебных планов',
-        ),
-        AsyncTaskType(
-            key='ASYNC_REQUEST',
-            title='Отправка асинхронных запросов',
-        ),
-        AsyncTaskType(
-            key='MASS_EXPULSION',
-            title='Массовый выпуск',
-        ),
-        AsyncTaskType(
-            key='AIO_CLIENT',
-            title='AIO клиент',
-        ),
-    ], ignore_conflicts=True)
+    AsyncTaskType.objects.bulk_create(
+        [
+            AsyncTaskType(
+                key='UNKNOWN',
+                title='Неизвестно',
+            ),
+            AsyncTaskType(
+                key='SYSTEM',
+                title='Системная',
+            ),
+            AsyncTaskType(
+                key='REPORT',
+                title='Отчет',
+            ),
+            AsyncTaskType(
+                key='IMPORT',
+                title='Импорт данных',
+            ),
+            AsyncTaskType(
+                key='SCHEDULE_FORMING',
+                title='Формирование расписания',
+            ),
+            AsyncTaskType(
+                key='SCHEDULE_CLEANER',
+                title='Очищение расписания',
+            ),
+            AsyncTaskType(
+                key='SCHEDULE_PATTERN_COPY',
+                title='Копирование шаблона расписания',
+            ),
+            AsyncTaskType(
+                key='ST_PRINTING',
+                title='Печать учебных планов',
+            ),
+            AsyncTaskType(
+                key='ASYNC_REQUEST',
+                title='Отправка асинхронных запросов',
+            ),
+            AsyncTaskType(
+                key='MASS_EXPULSION',
+                title='Массовый выпуск',
+            ),
+            AsyncTaskType(
+                key='AIO_CLIENT',
+                title='AIO клиент',
+            ),
+        ],
+        ignore_conflicts=True,
+    )
 
 
 def init_task_statuses(apps, schema_editor):
     """Заполнение первоначальными данными AsyncTaskStatus."""
     AsyncTaskStatus = apps.get_model('async_task', 'AsyncTaskStatus')  # noqa: N806
 
-    AsyncTaskStatus.objects.bulk_create([
-        AsyncTaskStatus(
-            key='PENDING',
-            title='В ожидании',
-        ),
-        AsyncTaskStatus(
-            key='RECEIVED',
-            title='В очереди',
-        ),
-        AsyncTaskStatus(
-            key='STARTED',
-            title='Выполняется',
-        ),
-        AsyncTaskStatus(
-            key='SUCCESS',
-            title='Успешно выполнена',
-        ),
-        AsyncTaskStatus(
-            key='REVOKED',
-            title='Остановлена',
-        ),
-        AsyncTaskStatus(
-            key='FAILURE',
-            title='Ошибка',
-        ),
-        AsyncTaskStatus(
-            key='RETRY',
-            title='Перезапуск',
-        ),
-        AsyncTaskStatus(
-            key='IGNORED',
-            title='Игнорирована',
-        ),
-        AsyncTaskStatus(
-            key='REJECTED',
-            title='Отменена',
-        ),
-        AsyncTaskStatus(
-            key='UNKNOWN',
-            title='Неизвестно',
-        ),
-    ], ignore_conflicts=True)
+    AsyncTaskStatus.objects.bulk_create(
+        [
+            AsyncTaskStatus(
+                key='PENDING',
+                title='В ожидании',
+            ),
+            AsyncTaskStatus(
+                key='RECEIVED',
+                title='В очереди',
+            ),
+            AsyncTaskStatus(
+                key='STARTED',
+                title='Выполняется',
+            ),
+            AsyncTaskStatus(
+                key='SUCCESS',
+                title='Успешно выполнена',
+            ),
+            AsyncTaskStatus(
+                key='REVOKED',
+                title='Остановлена',
+            ),
+            AsyncTaskStatus(
+                key='FAILURE',
+                title='Ошибка',
+            ),
+            AsyncTaskStatus(
+                key='RETRY',
+                title='Перезапуск',
+            ),
+            AsyncTaskStatus(
+                key='IGNORED',
+                title='Игнорирована',
+            ),
+            AsyncTaskStatus(
+                key='REJECTED',
+                title='Отменена',
+            ),
+            AsyncTaskStatus(
+                key='UNKNOWN',
+                title='Неизвестно',
+            ),
+        ],
+        ignore_conflicts=True,
+    )
 
 
 class Migration(migrations.Migration):
-
     dependencies = [
         ('async_task', '0001_initial'),
     ]

educommon/async_task/migrations/0003_alter_runningtask_options.py

@@ -4,7 +4,6 @@ from django.db import migrations, models
 
 
 class Migration(migrations.Migration):
-
     dependencies = [
         ('async_task', '0002_task_type_and_status_data'),
     ]

educommon/async_task/models.py

@@ -1,4 +1,5 @@
 """Модели для асинхронных задач Celery."""
+
 from typing import (
     Optional,
 )
@@ -130,9 +131,13 @@ class AnnotatedRunningTaskManager(Manager):
 
     def get_queryset(self):
         """Возвращает кварисет с аннотированием."""
-        return super().get_queryset().annotate(
-            task_type_str=F('task_type__title'),
-            status_str=F('status__title'),
+        return (
+            super()
+            .get_queryset()
+            .annotate(
+                task_type_str=F('task_type__title'),
+                status_str=F('status__title'),
+            )
         )
 
 
@@ -221,8 +226,6 @@ class RunningTask(ModelValidationMixin, BaseObjectModel):
         return getattr(self.user_profile, 'fullname', str(self.user_profile))
 
     class Meta:
-        indexes = (
-            Index(fields=['profile_type', 'profile_id']),
-        )
+        indexes = (Index(fields=['profile_type', 'profile_id']),)
         verbose_name = 'Асинхронная задача'
         verbose_name_plural = 'Асинхронные задачи'