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

educommon/utils/serializer.py

@@ -1,4 +1,5 @@
 """Инструменты для сериализации моделей."""
+
 from collections import (
     defaultdict,
 )
@@ -120,19 +121,15 @@ class SerializeQueue:
             attname = field.attname
             if attname.endswith('_id'):
                 attname = attname.replace('_id', '')
-                attname = '%s__in' % attname
+                attname = f'{attname}__in'
             # добавление фильтра вхождения
             objects = self._include_conditions.get(rel_model._meta.object_name)
             if objects:
-                query_set = query_set.filter(
-                    **{attname: objects}
-                )
+                query_set = query_set.filter(**{attname: objects})
             # добавление фильтра исключения
             objects = self._exclude_conditions.get(rel_model._meta.object_name)
             if objects:
-                query_set = query_set.exclude(
-                    **{attname: objects}
-                )
+                query_set = query_set.exclude(**{attname: objects})
 
         return query_set
 
@@ -144,14 +141,12 @@ class SerializeQueue:
         :return: список кортежей вида [(поле, ссылочная модель), ...]
         """
         return [
-            (field, get_related(field).parent_model) for
-            field in model._meta.fields
-            if isinstance(field, ForeignKey)
+            (field, get_related(field).parent_model) for field in model._meta.fields if isinstance(field, ForeignKey)
         ]
 
     @staticmethod
     def related_objects(obj):
-        """ Возвращает список кверисетов зависимых моделей
+        """Возвращает список кверисетов зависимых моделей
 
         :param obj:
         :return:
@@ -163,11 +158,9 @@ class SerializeQueue:
             _attname = rel.field.attname
             if _attname.endswith('_id'):
                 _attname = _attname.replace('_id', '')
-            _attname = '%s__pk' % _attname
+            _attname = f'{_attname}__pk'
             # Пытаемся определить наличие зависимых объектов:
-            rel_qs = rel.field.model.objects.filter(
-                **{str(_attname): obj.id}
-            )
+            rel_qs = rel.field.model.objects.filter(**{str(_attname): obj.id})
             if rel_qs.exists():
                 result.append(rel_qs)
 
@@ -216,6 +209,6 @@ class SerializeQueue:
 
         :param filename: имя файла
         """
-        data = serializers.serialize("json", self._objects, indent=4)
+        data = serializers.serialize('json', self._objects, indent=4)
         with open(filename, 'wb') as json_out:
             json_out.write(data)

educommon/utils/storage.py

@@ -68,8 +68,9 @@ class AbstractInstanceDataStorage(AbstractInstanceStorage):
 
         :param instance: Объект модели
         """
-        if (not self.registry.is_model_has_handler(instance.__class__) or
-                self._is_instance_already_saved(instance, **kwargs)):
+        if not self.registry.is_model_has_handler(instance.__class__) or self._is_instance_already_saved(
+            instance, **kwargs
+        ):
             return
 
         self._save_instance_data(instance)

educommon/utils/system.py

@@ -57,9 +57,7 @@ def get_postgresql_version(connection):
     """
     with connection.cursor() as cursor:
         if cursor.db.vendor != 'postgresql':
-            raise RuntimeError(
-                'Only PostgreSQL RDBMS supported, not ' + cursor.db.vendor
-            )
+            raise RuntimeError(f'Only PostgreSQL RDBMS supported, not {cursor.db.vendor}')
 
         return (
             cursor.db.pg_version // 10000,

educommon/utils/system_app/management/commands/delete_objects.py

@@ -1,4 +1,5 @@
 """Management-команда для удаления обьектов."""
+
 import sys
 from collections import (
     defaultdict,
@@ -39,7 +40,7 @@ def call_custom_command(command_name, *args, **options):
         try:
             app_name = get_commands()[command_name]
         except KeyError:
-            raise CommandError("Unknown command: %r" % command_name)
+            raise CommandError(f'Unknown command: {command_name!r}')
 
         if isinstance(app_name, BaseCommand):
             # If the command is already loaded, use it directly.
@@ -52,16 +53,15 @@ def call_custom_command(command_name, *args, **options):
     parser = command.create_parser('', command_name)
     # Use the `dest` option name from the parser option
     opt_mapping = {
-        sorted(s_opt.option_strings)[0].lstrip('-').replace(
-            '-', '_'): s_opt.dest
-        for s_opt in parser._actions if s_opt.option_strings
+        sorted(s_opt.option_strings)[0].lstrip('-').replace('-', '_'): s_opt.dest
+        for s_opt in parser._actions
+        if s_opt.option_strings
     }
-    arg_options = {opt_mapping.get(key, key): value
-                   for key, value in options.items()}
+    arg_options = {opt_mapping.get(key, key): value for key, value in options.items()}
     options, un_options = parser.parse_known_args(args)
     for opt in un_options:
         if not isinstance(opt, str):
-            opt = opt.decode(sys.stdout.encoding)
+            opt = str(opt)
         com = opt.split('=')
         com = com[0]
         if '__in' in com:
@@ -92,7 +92,7 @@ class Command(BaseCommand):
         options, un_options = parser.parse_known_args(argv[2:])
         for opt in un_options:
             if not isinstance(opt, str):
-                opt = opt.decode(sys.stdout.encoding)
+                opt = str(opt)
             com = opt.split('=')
             com = com[0]
             if '__in' in com:
@@ -116,21 +116,15 @@ class Command(BaseCommand):
             if isinstance(e, SystemCheckError):
                 self.stderr.write(str(e), lambda x: x)
             else:
-                self.stderr.write('%s: %s' % (e.__class__.__name__, e))
+                self.stderr.write(f'{e.__class__.__name__}: {e}')
             sys.exit(1)
         finally:
             connections.close_all()
 
     def add_arguments(self, parser):
-        parser.add_argument(
-            '--count', action='count', help='Количество удаляемых обьектов'
-        )
-        parser.add_argument(
-            '--model', type=str, required=True, help='Модель для удаления'
-        )
-        parser.add_argument(
-            '--data', action='count', help='Вернуть json удаляемых обьектов'
-        )
+        parser.add_argument('--count', action='count', help='Количество удаляемых обьектов')
+        parser.add_argument('--model', type=str, required=True, help='Модель для удаления')
+        parser.add_argument('--data', action='count', help='Вернуть json удаляемых обьектов')
 
     @staticmethod
     def find_filter(options, ignore_opt=()):
@@ -177,10 +171,7 @@ class Command(BaseCommand):
             try:
                 model = apps.get_model(app_name, model_name)
             except LookupError:
-                message = (
-                    'Модели {} в приложении '
-                    '{} не найдено.'.format(model_name, app_name)
-                )
+                message = 'Модели {} в приложении {} не найдено.'.format(model_name, app_name)
             return model, message
         for app_config in apps.get_app_configs():
             try:
@@ -191,10 +182,7 @@ class Command(BaseCommand):
 
         if len(models) > 1:
             model = None
-            message = (
-                'Невозможно однозначно определить модель, '
-                'найдены похожие модели: \n'
-            )
+            message = 'Невозможно однозначно определить модель, найдены похожие модели: \n'
             message += '\n'.join(str(model._meta) for model in models)
         elif not model:
             message = 'Модели {} не найдено.'.format(model_name)
@@ -206,9 +194,7 @@ class Command(BaseCommand):
         for del_obj in deleted_objects:
             for model, model_objects in del_obj.get_related_objects():
                 for o in model_objects:
-                    uniq_dict[
-                        model.__name__ + ' ' + model._meta.verbose_name
-                    ].add(o)
+                    uniq_dict[model.__name__ + ' ' + model._meta.verbose_name].add(o)
         for model, objs in uniq_dict.items():
             display_mes = '{} {}'.format(model, len(objs))
             self.stdout.write(display_mes)
@@ -220,8 +206,7 @@ class Command(BaseCommand):
             for rel_model, rel_objs in instance.get_related_objects():
                 for obj in rel_objs:
                     objs.append(obj)
-        data = serializers.serialize(
-            'json', objs)
+        data = serializers.serialize('json', objs)
         self.stdout.write(data)
 
     def handle(self, *args, **options):
@@ -234,9 +219,7 @@ class Command(BaseCommand):
         if message:
             raise CommandError(message)
         # опции которые будут игнорироваться в фильтре
-        ignore_opt = (
-            'count', 'model', 'data', 'verbosity', 'stdout', 'skip_checks'
-        )
+        ignore_opt = ('count', 'model', 'data', 'verbosity', 'stdout', 'skip_checks')
         lookup = self.find_filter(options, ignore_opt)
         deleted_objects = model.objects.filter(**lookup)
 

educommon/utils/ui.py

@@ -1,10 +1,20 @@
 """Утилиты для работы с элементами управления (интерфейсами)."""
+from __future__ import (
+    annotations,
+)
+
 import inspect
 import os
 from datetime import (
+    date,
     datetime,
     time,
 )
+from typing import (
+    TYPE_CHECKING,
+    Callable,
+    Type,
+)
 
 from django.conf import (
     settings,
@@ -58,26 +68,29 @@ from educommon.utils.misc import (
 )
 
 
+if TYPE_CHECKING:
+    from django.db.models import (
+        Model,
+    )
+
+    from objectpack.filters import (
+        FilterGroup,
+    )
+
+
 def anchor100(*elements):
     """Установка anchor='100%' для перечня компонент."""
-    return list(
-        obj_anchor100(element)
-        for element in elements
-    )
+    return list(obj_anchor100(element) for element in elements)
 
 
 def deny_blank(*elements):
     """Установка allow_blank=False для перечня компонент."""
-    return list(
-        obj_deny_blank(element)
-        for element in elements
-    )
+    return list(obj_deny_blank(element) for element in elements)
 
 
 def make_button(title, icon_cls, event, client_id):
     """Создает кнопку, оповещающую компонент с client_id на событие event."""
-    handler = "function() {Ext.getCmp('%s').fireEvent('%s');}" % (
-        client_id, event)
+    handler = f'function() {{Ext.getCmp("{client_id}").fireEvent("{event}");}}'
 
     return ext.ExtButton(text=title, icon_cls=icon_cls, handler=handler)
 
@@ -107,7 +120,7 @@ class ChoicesFilter(CustomFilter):
         self._choices = choices
         kwargs['xtype'] = 'combo'
 
-        super(ChoicesFilter, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
     def get_script(self):
         """Генерация кода компонента."""
@@ -126,12 +139,8 @@ class ChoicesFilter(CustomFilter):
 
 
 class ColumnFilterWithDefaultValue(_FilterByField):
-
     def get_script(self):
-        control = _create_control_for_field(
-            self.field,
-            **self._field_fabric_params
-        )
+        control = _create_control_for_field(self.field, **self._field_fabric_params)
         control._put_config_value('filterName', self._uid)
         control._put_config_value('tooltip', self._tooltip or control.label)
         control.name = self._uid
@@ -142,8 +151,7 @@ class ColumnFilterWithDefaultValue(_FilterByField):
         return [control.render()]
 
 
-def reconfigure_grid_by_access(grid, can_add=False, can_edit=False,
-                               can_delete=False, can_view=True):
+def reconfigure_grid_by_access(grid, can_add=False, can_edit=False, can_delete=False, can_view=True):
     """Перенастраивает грид в зависимости от прав доступа.
 
     :param grid: Перенастраиваемый грид.
@@ -172,8 +180,7 @@ def reconfigure_grid_by_access(grid, can_add=False, can_edit=False,
         grid.url_delete = None
 
 
-def reconfigure_object_tree_by_access(grid, can_add=False, can_edit=False,
-                                      can_delete=False, can_view=True):
+def reconfigure_object_tree_by_access(grid, can_add=False, can_edit=False, can_delete=False, can_view=True):
     """Перенастраивает древовидный грид в зависимости от прав доступа.
 
     :param grid: Перенастраиваемый грид.
@@ -212,16 +219,14 @@ class FilterByField(_FilterByField):
         if parser:
             self.parsers_map = list(self.parsers_map)
             self.parsers_map.append(parser)
-        super(FilterByField, self).__init__(*args, **kwargs)
+
+        super().__init__(*args, **kwargs)
 
     def create_control(self):
         if self._control_creator is not None:
             return self._control_creator()
 
-        return _create_control_for_field(
-            self.field,
-            **self._field_fabric_params
-        )
+        return _create_control_for_field(self.field, **self._field_fabric_params)
 
     def get_control(self):
         control = self.create_control()
@@ -243,75 +248,84 @@ class DatetimeFilterCreator:
     Поддерживает значения по умолчанию.
     """
 
-    def __init__(self, model, field_name,
-                 get_from=lambda: None, get_to=lambda: None):
+    def __init__(
+        self,
+        model: Type[Model],
+        field_name: str,
+        get_from: Callable[[], None | date] = lambda: None,
+        get_to: Callable[[], None | date] = lambda: None,
+        min_value: Callable[[], None | date] = lambda: None,
+        max_value: Callable[[], None | date] = lambda: None,
+    ) -> None:
         """Фильтр по интервалу для datetime поля.
 
-        :param django.db.models.Model model: модель для фильтра.
-        :param str field_name: имя поля модели.
-        :param callable get_from: возвращает дату по умолчанию для фильтра "С".
-        :param callable get_to: возвращает дату по умолчанию для фильтра "По".
+        Args:
+            model: Модель для фильтра.
+            field_name: Имя поля модели.
+            get_from: Дата по умолчанию для фильтра "С".
+            get_to: Дата по умолчанию для фильтра "По".
+            min_value: Минимально возможная дата.
+            max_value: Максимально возможная дата.
 
         Значения по умолчанию передаются в качестве callable, чтобы они
         вычислялись во время создания js. То есть, если в фильтре должна быть
         текущая дата, а пак с колонками был создан вчера, пользователь увидит
         в фильтре сегодняшнюю дату, а не вчерашнюю.
         """
+
         self.model = model
         self.field_name = field_name
 
         assert callable(get_from)
         assert callable(get_to)
+        assert callable(min_value)
+        assert callable(max_value)
+
         self.defaults = {
             'from': get_from,
             'to': get_to,
+            'min': min_value if min_value() else lambda: date(1, 1, 1),
+            'max': max_value,
         }
 
     @cached_property
-    def filter(self):
+    def filter(self) -> FilterGroup:
         """Фильтр для колонки.
 
-        :return Группа колоночных фильтров для грида
-        :rtype objectpack.filters.FilterGroup
+        Returns:
+            Группа колоночных фильтров для грида.
         """
+
         observer = ioc.get('observer')
 
-        return (
-            FilterByField(
-                self.model,
-                model_register=observer,
-                control_creator=lambda: ext.ExtDateField(
-                    value=self.defaults['from'](),
-                ),
-                field_name=self.field_name,
-                lookup=lambda dt: Q(**{
-                    self.field_name + '__gte': datetime.combine(dt, time(0))
-                }),
-                tooltip='С',
-            ) & FilterByField(
-                self.model,
-                model_register=observer,
-                control_creator=lambda: ext.ExtDateField(
-                    value=self.defaults['to'](),
-                ),
-                field_name=self.field_name,
-                lookup=lambda dt: Q(**{
-                    self.field_name + '__lte': datetime.combine(
-                        dt, time(
-                            hour=23, minute=59, second=59, microsecond=999999
-                        )
-                    )
-                }),
-                tooltip='По',
-            )
+        return FilterByField(
+            self.model,
+            model_register=observer,
+            control_creator=lambda: ext.ExtDateField(
+                value=self.defaults['from'](),
+                min_value=self.defaults['min'](),
+                max_value=self.defaults['max'](),
+            ),
+            field_name=self.field_name,
+            lookup=lambda dt: Q(**{f'{self.field_name}__gte': datetime.combine(dt, time.min)}),
+            tooltip='С',
+        ) & FilterByField(
+            self.model,
+            model_register=observer,
+            control_creator=lambda: ext.ExtDateField(
+                value=self.defaults['to'](),
+                min_value=self.defaults['min'](),
+                max_value=self.defaults['max'](),
+            ),
+            field_name=self.field_name,
+            lookup=lambda dt: Q(**{f'{self.field_name}__lte': datetime.combine(dt, time.max)}),
+            tooltip='По',
         )
 
     @property
-    def base_params(self):
-        """Базовые параметры для store грида.
+    def base_params(self) -> dict[str, str]:
+        """Базовые параметры для store грида."""
 
-        :rtype: dict
-        """
         result = {}
 
         value = self.defaults['from']()
@@ -321,6 +335,7 @@ class DatetimeFilterCreator:
         value = self.defaults['to']()
         if value is not None:
             result[self.filter._items[1]._uid] = str(value)
+
         return result
 
 
@@ -335,7 +350,7 @@ def switch_window_in_read_only_mode(window):
     assert isinstance(window, BaseEditWindow), type(window)
 
     if window.title.endswith(': Редактирование'):
-        window.title = window.title[:-len('Редактирование')] + 'Просмотр'
+        window.title = window.title[: -len('Редактирование')] + 'Просмотр'
 
     window.buttons.remove(window.save_btn)
     window.cancel_btn.text = 'Закрыть'
@@ -358,16 +373,9 @@ def local_template(file_name):
     root_package_name = frame.f_globals['__name__'].rsplit('.', 2)[0]
     module = __import__(root_package_name)
 
-    TEMPLATE_DIRS = set(
-        path
-        for config in settings.TEMPLATES
-        for path in config.get('DIRS', ())
-    )
+    TEMPLATE_DIRS = set(path for config in settings.TEMPLATES for path in config.get('DIRS', ()))
 
-    assert any(
-        os.path.dirname(path) in TEMPLATE_DIRS
-        for path in module.__path__
-    ), (
+    assert any(os.path.dirname(path) in TEMPLATE_DIRS for path in module.__path__), (
         '{} package path must be in TEMPLATES config.'.format(module.__path__),
         TEMPLATE_DIRS,
     )
@@ -377,14 +385,13 @@ def local_template(file_name):
 
     for path in TEMPLATE_DIRS:
         if module_path.startswith(path):
-            module_path = module_path[len(path) + 1:]
+            module_path = module_path[len(path) + 1 :]
             break
 
     return os.path.join(module_path, file_name)
 
 
 class FilterByTextField(FilterByField):
-
     """Фильтр для поля TextField, с ExtStringField в качестве контрола.
 
     Возвращает контрол однострочного текстового поля
@@ -396,10 +403,7 @@ class FilterByTextField(FilterByField):
         # Работаем только с TextField
         assert isinstance(self.field, TextField)
 
-        return ext.ExtStringField(
-            max_length=self.field.max_length,
-            **self._field_fabric_params
-        )
+        return ext.ExtStringField(max_length=self.field.max_length, **self._field_fabric_params)
 
 
 def append_template_globals(comp, template):
@@ -417,8 +421,7 @@ def append_template_globals(comp, template):
     :type template: str or unicode
     """
     if not isinstance(comp, BaseExtComponent):
-        raise ApplicationLogicException(
-            'Component has no attribute template_globals')
+        raise ApplicationLogicException('Component has no attribute template_globals')
     if isinstance(comp.template_globals, str):
         # если template_globals - пустая строка, просто заменяем ее
         if len(comp.template_globals) == 0:

educommon/utils/xml/__init__.py

@@ -62,9 +62,7 @@ def parse_xml(xml):
 
 
 def get_text(elements):
-    """Возвращает текст первого элемента найденного
-        с помощью make_xpath_query
-    """
+    """Возвращает текст первого элемента найденного с помощью make_xpath_query."""
     return elements[0].text if elements else ''
 
 
@@ -74,9 +72,6 @@ def make_xpath_query(*tags):
     :param tags: Имена тэгов XML-документа в порядке иерархии (без учета
         пространств имен).
     """
-    result = '/' + ''.join(
-        "/*[local-name()='{}']".format(tag)
-        for tag in tags
-    )
+    result = '/' + ''.join("/*[local-name()='{}']".format(tag) for tag in tags)
 
     return result

educommon/utils/xml/resolver.py

@@ -29,6 +29,7 @@ class Resolver(etree.Resolver):
     .. code-block:: python
 
         from lxml import etree
+
         parser = etree.XMLParser(load_dtd=True)
         parser.resolvers.add(Resolver())
     """