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

educommon/objectpack/filters.py

@@ -33,9 +33,7 @@ class ColumnFilterEngine(BaseFilterEngine):
     def configure_grid(self, grid):
         """Метод конфигурации грида."""
         # расширение плагином
-        if not ExtensionManager().execute(
-            'column_filter_engine.configure_grid', self, grid
-        ):
+        if not ExtensionManager().execute('column_filter_engine.configure_grid', self, grid):
             super().configure_grid(grid)
 
 
@@ -50,7 +48,7 @@ class ModifiedChoicesFilter(CustomFilter):
         self._choices = choices
         kwargs['xtype'] = 'combo'
 
-        super(ModifiedChoicesFilter, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
     def create_control(self):
         """Контрол."""
@@ -58,6 +56,7 @@ class ModifiedChoicesFilter(CustomFilter):
             choices = self._choices()
         else:
             choices = self._choices
+
         return make_combo_box(data=list(choices))
 
     def get_control(self):
@@ -69,6 +68,7 @@ class ModifiedChoicesFilter(CustomFilter):
         control.allow_blank = True
         control.hide_clear_trigger = False
         control.value = None
+
         return control
 
     def get_script(self):
@@ -87,9 +87,7 @@ class BoolChoicesFilter(ModifiedChoicesFilter):
             """Формирование lookup для фильтра."""
             return Q(**{field_name: v}) if v is not None else Q()
 
-        super(BoolChoicesFilter, self).__init__(
-            *args, choices=choices, parser='boolean', lookup=lookup, **kwargs
-        )
+        super().__init__(*args, choices=choices, parser='boolean', lookup=lookup, **kwargs)
 
 
 class DateFilter(ColumnFilterWithDefaultValue):
@@ -97,10 +95,7 @@ class DateFilter(ColumnFilterWithDefaultValue):
 
     def create_control(self):
         """Создание контрола."""
-        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):
         """Настройка контрола."""
@@ -126,10 +121,7 @@ class DateFilterByAnnotatedField(DateFilter):
     собираются в кварисете через annotate.
     """
 
-    def __init__(
-        self, model, field_name, lookup=None, tooltip=None, default_value=None,
-        **field_fabric_params
-    ):
+    def __init__(self, model, field_name, lookup=None, tooltip=None, default_value=None, **field_fabric_params):
         """Инициализация параметров."""
         field_name = field_name.replace('.', '__')
         self._model = model
@@ -143,8 +135,10 @@ class DateFilterByAnnotatedField(DateFilter):
             if not callable(lookup) and '%s' in lookup:
                 lookup = lookup % field_name
         else:
+
             def lookup(x):
                 return Q(**{field_name: x})
+
         self._lookup = lookup
 
     def create_control(self):

educommon/objectpack/ui.py

@@ -32,9 +32,7 @@ from educommon.utils.ui import (
 
 
 class GridPanel(ext.ExtPanel):
-    """
-    Панель, имеющая grid_url, по которому получает грид и вставляет в себя
-    """
+    """Панель, имеющая grid_url, по которому получает грид и вставляет в себя."""
 
     grid_url = None
     template = 'grid-panel.js'
@@ -43,24 +41,21 @@ class GridPanel(ext.ExtPanel):
     def __init__(self, *args, **kwargs):
         # в инитах затирается темплейт
         t = self.template
-        super(GridPanel, self).__init__(*args, **kwargs)
+
+        super().__init__(*args, **kwargs)
+
         self.template = t
 
     @staticmethod
     def _create_grid(pack, columns, grid_cls, group_by=None, **kwargs):
-        """
-        Метод возвращает грид
+        """Метод возвращает грид.
+
         :param grid_cls: класс грида
         :type grid_cls: ExtObjectGrid
         :param str group_by: темплейт для группирования
         """
         grid = grid_cls(
-            region='north',
-            force_fit=False,
-            auto_scroll=True,
-            auto_width=False,
-            cls='word-wrap-grid',
-            **kwargs
+            region='north', force_fit=False, auto_scroll=True, auto_width=False, cls='word-wrap-grid', **kwargs
         )
         grid.flex = 1
         grid.sm = ext.ExtGridCellSelModel()
@@ -72,23 +67,17 @@ class GridPanel(ext.ExtPanel):
         # если грид с группирующими строками
         if group_by:
             grid.store = ext_store.ExtGroupingStore(
-                url=grid.get_store().url,
-                total_property='total',
-                root='rows',
-                auto_load=True
-            )
-            grid.store.reader = ext_store.ExtJsonReader(
-                total_property='total',
-                root='rows')
-            grid.view = ExtGridGroupingView(
-                group_text_template=group_by,
-                force_fit=grid.force_fit
+                url=grid.get_store().url, total_property='total', root='rows', auto_load=True
             )
+            grid.store.reader = ext_store.ExtJsonReader(total_property='total', root='rows')
+            grid.view = ExtGridGroupingView(group_text_template=group_by, force_fit=grid.force_fit)
 
             def configure_reader(col):
                 grid.store.reader.set_fields(col['data_index'])
         else:
-            configure_reader = lambda col: None
+
+            def configure_reader(col):
+                return None
 
         def populate(root, columns):
             for c in columns:
@@ -123,7 +112,7 @@ class GridPanel(ext.ExtPanel):
 
     @classmethod
     def configure_grid(cls, grid, params):
-        """Конфигурирование грида"""
+        """Конфигурирование грида."""
 
         pack = params['pack']
         # обычное поведение
@@ -138,6 +127,7 @@ class GridPanel(ext.ExtPanel):
     @classmethod
     def create_grid(cls, pack, columns, **kwargs):
         grid = cls._create_grid(pack, columns, cls.grid_class, **kwargs)
+
         return grid
 
     def pre_render(self):
@@ -146,35 +136,30 @@ class GridPanel(ext.ExtPanel):
 
     def render(self):
         self.pre_render()
-        self.cmp_code = super(GridPanel, self).render()
+
+        self.cmp_code = super().render()
+
         return render_component(self)
 
 
 class FilterPanel(ext.ExtPanel):
-    """
-    Панель, умеющая fireevent'ить об изменении контрола,
-    входящего в список filters
-    """
+    """Панель, умеющая fireevent'ить об изменении контрола, входящего в список filters."""
 
     def __init__(self, *args, **kwargs):
         super(FilterPanel, self).__init__(*args, **kwargs)
+
         self.filters = []
 
     def configure_redirect(self, control, event):
+        """Связывает текущую панель с контролом control посредством fireevent'а event."""
+        self._listeners['changed'] = f"""
+        function(params) {{
+            Ext.getCmp('{control.client_id}').fireEvent('{event}', params);
+        }}
         """
-        Связывает текущую панель с контролом control
-        посредством fireevent'а event
-        """
-        self._listeners["changed"] = """
-            function(params) {
-                Ext.getCmp('%s').fireEvent('%s', params)
-            }""" % (control.client_id, event)
 
     def configure_events(self):
-        """
-        Дополнение рендера fireevent'ом изменения значения контролов,
-        входящих в список filters панели
-        """
+        """Дополнение рендера fireevent'ом изменения значения контролов, входящих в список filters панели."""
         for control in self.filters:
             # определяется что за контрол и приделываются разные events
             if isinstance(control, ComboBoxWithStore):
@@ -195,25 +180,28 @@ class FilterPanel(ext.ExtPanel):
     def render(self):
         self.configure_events()
         self.pre_render()
+
         self.cmp_code = super(FilterPanel, self).render()
+
         # где-то в инитах затирается темплейт, опишем еще раз
         self.template = 'filter-panel.js'
+
         return render_component(self)
 
 
 class BaseGridWindow(BaseWindow):
-    """
-    Базовое окно с фильтрующей панелью и панелью с гридом
+    """Базовое окно с фильтрующей панелью и панелью с гридом.
+
     Клиент получает панель с гридом с сервера при изменении
-    полей фильтрации на фильтрующей панели
+    полей фильтрации на фильтрующей панели.
     """
+
     grid_panel_cls = GridPanel  # панель грида
 
     def _init_grid_panel(self):
         """Панель для грида."""
         self.grid_panel = self.grid_panel_cls(
-            region='center', layout='hbox', flex=1,
-            layout_config={"align": "stretch"}
+            region='center', layout='hbox', flex=1, layout_config={'align': 'stretch'}
         )
 
     def _init_filter_panel(self):
@@ -229,7 +217,8 @@ class BaseGridWindow(BaseWindow):
         )
 
     def _init_components(self):
-        super(BaseGridWindow, self)._init_components()
+        super()._init_components()
+
         self._init_grid_panel()
         self._init_filter_panel()
         # связываются две панели
@@ -238,7 +227,8 @@ class BaseGridWindow(BaseWindow):
         self._mro_exclude_list.append(self.filter_cnt)
 
     def _do_layout(self):
-        super(BaseGridWindow, self)._do_layout()
+        super()._do_layout()
+
         self.layout = 'border'
         self.maximizable = self.maximized = True
         self.minimizable = True
@@ -247,20 +237,16 @@ class BaseGridWindow(BaseWindow):
         self.grid_panel.layout_config['align'] = 'stretch'
 
         # добавление фильтрующих полей в фильтрующую панель
-        assert self.filter_cnt.filters, (
-            'Необходимо добавить элементы в список фильтров '
-            '(self.filter_cnt.filters)!')
+        assert self.filter_cnt.filters, 'Необходимо добавить элементы в список фильтров (self.filter_cnt.filters)!'
 
-        self.items.extend([
-            self.filter_cnt, self.grid_panel
-        ])
+        self.items.extend([self.filter_cnt, self.grid_panel])
 
     def set_params(self, params):
+        super().set_params(params)
 
-        super(BaseGridWindow, self).set_params(params)
         self.template_globals = 'base-grid-window.js'
 
-        self.pack = params["grid_pack"]
+        self.pack = params['grid_pack']
 
         # урл получения грида для панели с гридом
         self.grid_panel.grid_url = self.pack.get_grid_action_url()
@@ -279,17 +265,18 @@ class RelatedErrorWindow(BaseWindow):
     Показывается, если невозможно удаление записи из-за наличия ссылок
     на удаляемый объект.
     """
+
     def _init_components(self):
-        super(RelatedErrorWindow, self)._init_components()
-        self.title = "Внимание!"
+        super()._init_components()
+
+        self.title = 'Внимание!'
         self.layout = 'fit'
-        self.panel = ext.ExtPanel(
-            auto_scroll=True
-        )
+        self.panel = ext.ExtPanel(auto_scroll=True)
         self.items.append(self.panel)
 
     def set_params(self, params):
-        super(RelatedErrorWindow, self).set_params(params)
+        super().set_params(params)
+
         assert 'html' in params
         self.panel.html = params['html']
 
@@ -303,19 +290,17 @@ class _ListWindowMixin:
     """
 
     def __init__(self):
-        super(_ListWindowMixin, self).__init__()
+        super().__init__()
 
-        self._mro_exclude_list.extend((
-            self.grid,
-        ))
+        self._mro_exclude_list.extend((self.grid,))
 
     def _init_components(self):
-        super(_ListWindowMixin, self)._init_components()
+        super()._init_components()
 
         self._mro_exclude_list.remove(self.grid.top_bar.button_refresh)
 
     def set_params(self, params):
-        super(_ListWindowMixin, self).set_params(params)
+        super().set_params(params)
 
         if params.get('read_only'):
             reconfigure_grid_by_access(self.grid)
@@ -334,7 +319,7 @@ class _SelectWindowMixin(_ListWindowMixin):
     """Класс-примесь для окон выбора объектов."""
 
     def set_params(self, params):
-        super(_SelectWindowMixin, self).set_params(params)
+        super().set_params(params)
 
         reconfigure_grid_by_access(self.grid, can_view=False)
 
@@ -357,14 +342,11 @@ class BaseMultiSelectWindow(_SelectWindowMixin, OPBaseMultiSelectWindow):
     """
 
     def set_params(self, params):
-        super(BaseMultiSelectWindow, self).set_params(params)
+        super().set_params(params)
+
         self.grid.allow_paging = False
-        self.multiselect_page_fix = local_template(
-            'templates/multiselect-page-fix.js'
-        )
-        self.template_globals = local_template(
-            'templates/multiSelectWindow.js'
-        )
+        self.multiselect_page_fix = local_template('templates/multiselect-page-fix.js')
+        self.template_globals = local_template('templates/multiSelectWindow.js')
 
 
 class EditWindowMixin:
@@ -377,7 +359,7 @@ class EditWindowMixin:
     """
 
     def set_params(self, params):
-        super(EditWindowMixin, self).set_params(params)
+        super().set_params(params)
 
         if params.get('read_only'):
             # TODO: Выпилить эту функцию, а ее код перенести сюда

educommon/report/__init__.py

@@ -4,6 +4,7 @@
 различных элементов отчётной подсистемы: провайдера данных, построителя отчёта
 и собственно отчёта.
 """
+
 from abc import (
     ABCMeta,
     abstractmethod,
@@ -209,7 +210,7 @@ class AbstractReportBuilder(metaclass=ABCMeta):
 
     @abstractmethod
     def build(self):
-        """ Метод, осуществляющий построение отчёта.
+        """Метод, осуществляющий построение отчёта.
 
         Должен возвращать результат в виде файла или иной структуры данных.
         """
@@ -241,7 +242,7 @@ class BaseProviderAdapter(Mapping, dict):
 
         'Магические' и некоторые отдельные методы будут игнорироваться.
         """
-        return not(attr.startswith('_') or attr in self._attrs_stop_list)
+        return not (attr.startswith('_') or attr in self._attrs_stop_list)
 
 
 class FlatDataProviderAdapter(BaseProviderAdapter):
@@ -265,7 +266,7 @@ class FlatDataProviderAdapter(BaseProviderAdapter):
         """
         assert isinstance(splitter, str), type(splitter)
 
-        super(FlatDataProviderAdapter, self).__init__(provider)
+        super().__init__(provider)
 
         self.level_splitter = splitter
         self._all_keys = self._get_all_keys(self.provider)
@@ -274,7 +275,7 @@ class FlatDataProviderAdapter(BaseProviderAdapter):
         """Все ключи в иерархии провайдеров."""
         result = []
         if key_level is None:
-            key_level = ""
+            key_level = ''
         else:
             if key_level:
                 key_level += self.level_splitter + provider.name
@@ -333,6 +334,7 @@ class FlatDataProviderAdapter(BaseProviderAdapter):
 
     def __bool__(self):
         return bool(self._all_keys)
+
     __nonzero__ = __bool__
 
     def __iter__(self):
@@ -361,7 +363,8 @@ class NestedDataProviderAdapter(BaseProviderAdapter):
 
         :param provider: провайдер данных
         """
-        super(NestedDataProviderAdapter, self).__init__(provider)
+        super().__init__(provider)
+
         self._all_keys = self._get_top_keys(self.provider)
 
     def _get_top_keys(self, provider):
@@ -410,6 +413,7 @@ class NestedDataProviderAdapter(BaseProviderAdapter):
 
     def __bool__(self):
         return bool(self._all_keys)
+
     __nonzero__ = __bool__
 
     def __iter__(self):

educommon/report/actions.py

@@ -1,4 +1,5 @@
 """Генерация отчётов средствами платформы M3."""
+
 from m3 import (
     ApplicationLogicException,
 )
@@ -17,7 +18,6 @@ from objectpack.ui import (
 
 
 class BaseReportPack(BasePack):
-
     """Базовый класс отчёта.
 
     Отчёты на любых движках могут быть описаны на основе этого класса.
@@ -74,19 +74,19 @@ def download_result(url):
         url = str(url, 'utf-8')
     return OperationResult(
         success=True,
-        code="""
-            (function(){
+        code=f"""
+            (function() {{
                 var hiddenIFrameID = 'hiddenDownloader',
                     iframe = document.getElementById(hiddenIFrameID);
-                if (iframe === null) {
+                if (iframe === null) {{
                     iframe = document.createElement('iframe');
                     iframe.id = hiddenIFrameID;
                     iframe.style.display = 'none';
                     document.body.appendChild(iframe);
-                }
-                iframe.src = "%s";
-            })()
-        """ % url
+                }}
+                iframe.src = "{url}";
+            }})()
+        """,
     )
 
 
@@ -105,12 +105,12 @@ class CommonReportWindowAction(BaseWindowAction):
 
     def set_window_params(self):
         """Задание параметров окна."""
-        super(CommonReportWindowAction, self).set_window_params()
+        super().set_window_params()
+
         params = self.win_params.copy()
         params['title'] = self.parent.title
         params['form_url'] = self.parent.get_reporting_url()
-        self.win_params = self.parent.set_report_window_params(
-            params, self.request, self.context)
+        self.win_params = self.parent.set_report_window_params(params, self.request, self.context)
 
 
 class CommonReportAction(BaseAction):
@@ -130,12 +130,12 @@ class CommonReportAction(BaseAction):
             builder_params.update(title=pack.title)
         # генерация отчёта
         out_file_url = pack.make_report(provider_params, builder_params)
+
         return download_result(out_file_url.encode('utf-8'))
 
 
 class CommonReportPack(BasePack):
-    """
-    Пак, реализующий генерацию отчётов.
+    """Пак, реализующий генерацию отчётов.
 
     Использует класс-построитель reporter.
     """
@@ -159,14 +159,16 @@ class CommonReportPack(BasePack):
 
     def __init__(self):
         """Конструктор пака генерации отчётов."""
-        super(CommonReportPack, self).__init__()
+        super().__init__()
 
         self.report_window_action = CommonReportWindowAction()
         self.report_action = CommonReportAction()
-        self.actions.extend([
-            self.report_window_action,
-            self.report_action,
-        ])
+        self.actions.extend(
+            [
+                self.report_window_action,
+                self.report_action,
+            ]
+        )
 
     def get_reporting_url(self):
         """Отдаёт адрес форме, куда передавать данные для обработки."""
@@ -174,7 +176,7 @@ class CommonReportPack(BasePack):
 
     @staticmethod
     def context2dict(context):
-        """преобразование контекста в словарь."""
+        """Преобразование контекста в словарь."""
         result = {}
         for key, value in context.__dict__.items():
             try:
@@ -187,16 +189,14 @@ class CommonReportPack(BasePack):
         return result
 
     def check_report_params(self, request, context):
-        """
-        Проверка передаваемых параметров для формирования отчёта.
+        """Проверка передаваемых параметров для формирования отчёта.
 
         :raise: ApplicationLogicException
         """
         pass
 
     def get_provider_params(self, request, context):
-        """
-        Преобразование request, context к словарю для создания провайдера.
+        """Преобразование request, context к словарю для создания провайдера.
 
         :param request:
         :param context:
@@ -204,8 +204,7 @@ class CommonReportPack(BasePack):
         return {}
 
     def get_builder_params(self, request, context):
-        """
-        Преобразование request, context к словарю для создания билдера.
+        """Преобразование request, context к словарю для создания билдера.
 
         :param request:
         :param context:
@@ -213,8 +212,7 @@ class CommonReportPack(BasePack):
         return {}
 
     def init_reporter(self, provider_params, builder_params):
-        """
-        Инициализация построителя с передачей параметров билдеру и провайдеру.
+        """Инициализация построителя с передачей параметров билдеру и провайдеру.
 
         Не требует переопределения.
         """
@@ -224,20 +222,19 @@ class CommonReportPack(BasePack):
         """Синхронное построение отчёта. Не требует переопределения."""
         reporter = self.init_reporter(provider_params, builder_params)
         url = reporter.make_report()
+
         return url
 
     def set_report_window_params(self, params, request, context):
         """Дополнение параметров окна отчёта."""
-        if self.reporter_class.extension not in (
-            self.reporter_class._available_extensions
-        ):
+        if self.reporter_class.extension not in (self.reporter_class._available_extensions):
             raise ApplicationLogicException('Расширение указано неверно!')
         params['extension'] = self.reporter_class.extension
+
         return params
 
     def create_report_window(self, request, context):
-        """
-        Cоздание окна настройки параметров отчёта.
+        """Cоздание окна настройки параметров отчёта.
 
         Не требует переопределения.
         """

educommon/report/constructor/__init__.py

@@ -2,6 +2,7 @@
 
 Поддерживает конструирование пользователем простых отчетов в формате Excel.
 """
+
 import django
 from pkg_resources import (
     get_distribution,
@@ -19,16 +20,12 @@ default_app_config = __name__ + '.apps.AppConfig'
 dist = get_distribution('m3-ui').version
 version = tuple(int(x) for x in dist.split('.'))
 
-assert (
-    (2, 0, 9) <= version < (2, 1) or
-    (2, 1, 9) <= version < (2, 2) or
-    (2, 2, 11) <= version < (2, 3)
-), 'Конструктор отчетов не поддерживает версию {} пакета m3-ui'.format(dist)
+assert (2, 0, 9) <= version < (2, 1) or (2, 1, 9) <= version < (2, 2) or (2, 2, 11) <= version < (2, 3), (
+    'Конструктор отчетов не поддерживает версию {} пакета m3-ui'.format(dist)
+)
 # -----------------------------------------------------------------------------
 # Проверка версии Django
 
 
-assert django.VERSION >= (1, 8), (
-    'Конструктор отчетов работает только в системах на базе Django 1.8+'
-)
+assert django.VERSION >= (1, 8), 'Конструктор отчетов работает только в системах на базе Django 1.8+'
 # -----------------------------------------------------------------------------

educommon/report/constructor/app_meta.py

@@ -7,6 +7,4 @@ from educommon.report.constructor.editor.actions import (
 
 
 def register_actions():
-    ioc.get('main_controller').packs.extend((
-        Pack(),
-    ))
+    ioc.get('main_controller').packs.extend((Pack(),))

educommon/report/constructor/apps.py

@@ -11,6 +11,7 @@ from django.db.models.functions import (
 
 
 class AppConfig(config.AppConfig):
+    """Конфигурация приложения конструктора отчётов."""
 
     name = __name__.rpartition('.')[0]
     label = 'report_constructor'