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

educommon/audit_log/README.rst

@@ -0,0 +1,64 @@
+Приложение "Логирование изменений объектов на уровне БД"
+=================================
+
+Установка
+--------------
+1. На основе абстрактного класса LogProxy из educommon/audit_log/proxies.py создать класс и реализовать его абстрактные 
+методы. 
+
+.. code-block:: python
+
+    class AuditLogProxy(LogProxy):
+        """Прокси-модель для отображения логов."""
+
+        class Meta:
+            proxy = True
+
+        @property
+        def user_fullname(self) -> str:
+            """Полное имя пользователя."""
+            pass
+
+        @property
+        def user_organization(self) -> str:
+            """Название организации, к которой привязан пользователь."""
+            pass
+
+
+В случае использования сервисной базы для нового класса необходимо реализовать
+роутер на основе ServiceDbRouterBase из educommon/django/db/routers.py и добавить его в settings.DATABASE_ROUTERS
+
+.. code-block:: python
+
+    class AuditLogProxyDbRouter(MyServiceDbRouterBase):
+        """Роутер базы данных для AuditLogProxy."""
+
+        app_name = 'model_app_name'
+        service_db_model_names = {'AuditLogProxy'}
+
+
+2. На основе абстрактного класса AuditLogPack из educommon/audit_log/actions.py создать класс и реализовать его абстрактные 
+методы. В атрибуте model указать модель из пункта "1".
+
+.. code-block:: python
+
+    class AuditPack(AuditLogPack):
+        """Журнал изменений."""
+
+        title = 'Журнал изменений (новый)'
+        model = AuditLogProxy
+
+        def _make_name_filter(self, field, value):
+            """Создает lookup фильтра по фамилии/имени/отчеству пользователя.
+
+            :param str field: название поля ('firstname', 'surname', 'patronymic').
+            :param str value: значение, по которому фильтруется queryset.
+            """
+            pass
+
+Выполнить регистрацию нового пака с помощью контроллера основных приложений проекта.
+
+3. Добавить 'educommon.audit_log.middleware.AuditLogMiddleware', расположив его так, чтобы при его отработке 
+в request уже был определен пользователь.
+
+4. Создать и выполнить миграции.

educommon/audit_log/actions.py

@@ -1,3 +1,7 @@
+from abc import (
+    ABCMeta,
+    abstractmethod,
+)
 from datetime import (
     date,
     timedelta,
@@ -45,7 +49,6 @@ from educommon.audit_log.ui import (
 from educommon.audit_log.utils import (
     get_model_choices,
     make_hstore_filter,
-    make_name_filter,
 )
 from educommon.m3 import (
     PackValidationMixin,
@@ -59,7 +62,7 @@ from educommon.utils.ui import (
 )
 
 
-class AuditLogPack(ViewWindowPackMixin, PackValidationMixin, ObjectPack):
+class AuditLogPack(ViewWindowPackMixin, PackValidationMixin, ObjectPack, metaclass=ABCMeta):
     """Журнал изменений."""
 
     title = 'Журнал изменений'
@@ -82,64 +85,81 @@ class AuditLogPack(ViewWindowPackMixin, PackValidationMixin, ObjectPack):
         model, 'time', get_from=lambda: date.today() - timedelta(days=2), get_to=date.today
     )
 
-    columns = [
-        {'data_index': 'time', 'width': 140, 'header': 'Дата и время', 'sortable': True, 'filter': date_filter.filter},
-        {
-            'data_index': 'user_name',
-            'width': 130,
-            'header': 'Пользователь',
-            'filter': ff('table__name', lookup=lambda x: make_name_filter('surname', x))
-            & ff('table__name', lookup=lambda x: make_name_filter('firstname', x))
-            & ff('table__name', lookup=lambda x: make_name_filter('patronymic', x)),
-        },
-        {
-            'data_index': 'operation',
-            'width': 60,
-            'header': 'Операция',
-            'filter': ff('operation', ask_before_deleting=False),
-        },
-        {
-            'data_index': 'model_name',
-            'width': 220,
-            'header': 'Модель объекта',
-            'filter': ff(
-                'table',
-                control_creator=lambda: make_combo_box(
-                    data=get_model_choices(),
-                    ask_before_deleting=False,
+    def _generate_columns(self):
+        """Формирует наполнение столбцов."""
+        columns = [
+            {
+                'data_index': 'time',
+                'width': 140,
+                'header': 'Дата и время',
+                'sortable': True,
+                'filter': self.date_filter.filter
+            },
+            {
+                'data_index': 'user_name',
+                'width': 130,
+                'header': 'Пользователь',
+                'filter': self.ff('table__name', lookup=lambda x: self._make_name_filter('surname', x))
+                & self.ff('table__name', lookup=lambda x: self._make_name_filter('firstname', x))
+                & self.ff('table__name', lookup=lambda x: self._make_name_filter('patronymic', x)),
+            },
+            {
+                'data_index': 'operation',
+                'width': 60,
+                'header': 'Операция',
+                'filter': self.ff('operation', ask_before_deleting=False),
+            },
+            {
+                'data_index': 'model_name',
+                'width': 220,
+                'header': 'Модель объекта',
+                'filter': self.ff(
+                    'table',
+                    control_creator=lambda: make_combo_box(
+                        data=get_model_choices(),
+                        ask_before_deleting=False,
+                    ),
+                ),
+            },
+            {
+                'data_index': 'object_id',
+                'width': 50,
+                'header': 'Код объекта',
+                'filter': self.ff('object_id'),
+            },
+            {
+                'data_index': 'ip',
+                'width': 60,
+                'header': 'IP',
+                'filter': self.ff(
+                    'ip',
+                    parser_map=(GenericIPAddressField, 'str', '%s__contains'),
+                    control_creator=ExtStringField,
                 ),
-            ),
-        },
-        {
-            'data_index': 'object_id',
-            'width': 50,
-            'header': 'Код объекта',
-            'filter': ff('object_id'),
-        },
-        {
-            'data_index': 'ip',
-            'width': 60,
-            'header': 'IP',
-            'filter': ff(
-                'ip',
-                parser_map=(GenericIPAddressField, 'str', '%s__contains'),
-                control_creator=ExtStringField,
-            ),
-        },
-        {
-            'data_index': 'object_string',
-            'width': 180,
-            'header': 'Объект',
-            'filter': ff(
-                'data',
-                parser_map=(HStoreField, 'str', '%s__values__icontains'),
-                lookup=lambda x: make_hstore_filter('data', x),
-                control_creator=ExtStringField,
-            ),
-        },
-    ]
+            },
+            {
+                'data_index': 'object_string',
+                'width': 180,
+                'header': 'Объект',
+                'filter': self.ff(
+                    'data',
+                    parser_map=(HStoreField, 'str', '%s__values__icontains'),
+                    lookup=lambda x: make_hstore_filter('data', x),
+                    control_creator=ExtStringField,
+                ),
+            },
+            {
+                'data_index': '',
+                'width': 40,
+                'header': 'Имитация',
+            },
+        ]
+
+        return columns
 
     def __init__(self):
+        self.columns = self._generate_columns()
+
         super().__init__()
 
         self.view_changes_action = ViewChangeAction()
@@ -187,6 +207,14 @@ class AuditLogPack(ViewWindowPackMixin, PackValidationMixin, ObjectPack):
             menu.Item(self.title, self.list_window_action),
         )
 
+    @abstractmethod
+    def _make_name_filter(self, field, value):
+        """Создает lookup фильтра по фамилии/имени/отчеству пользователя.
+
+        :param str field: название поля ('firstname', 'surname', 'patronymic').
+        :param str value: значение, по которому фильтруется queryset.
+        """
+
 
 class ViewChangeAction(BaseAction):
     """Action для просмотра изменений."""
@@ -203,7 +231,7 @@ class ViewChangeAction(BaseAction):
         """Тело Action, вызывается при обработке запроса к серверу."""
         object_id = getattr(context, self.parent.id_param_name)
         if object_id:
-            rows = LogProxy.objects.get(id=object_id).diff
+            rows = self.parent.model.objects.get(id=object_id).diff
         else:
             rows = []
 

educommon/audit_log/app_meta.py

@@ -1,9 +1,6 @@
 from educommon import (
     ioc,
 )
-from educommon.audit_log.actions import (
-    AuditLogPack,
-)
 from educommon.audit_log.error_log.actions import (
     PostgreSQLErrorPack,
 )
@@ -13,7 +10,6 @@ def register_actions():
     """Регистрация паков и экшенов."""
     ioc.get('main_controller').packs.extend(
         (
-            AuditLogPack(),
             PostgreSQLErrorPack(),
         )
     )

educommon/audit_log/proxies.py

@@ -1,5 +1,10 @@
 import os
 
+from abc import (
+    ABCMeta,
+    abstractmethod,
+)
+
 from django.conf import (
     settings,
 )
@@ -36,8 +41,12 @@ from educommon.audit_log.models import (
 )
 
 
-class LogProxy(AuditLog):
-    """Прокси-модель для отображения."""
+class LogProxyMeta(type(AuditLog), ABCMeta):
+    """Метакласс для устранения конфликта при наследовании от AuditLog и использовании ABCMeta"""
+
+
+class LogProxy(AuditLog, metaclass=LogProxyMeta):
+    """Абстрактный класс прокси-модели для отображения."""
 
     class Meta:
         proxy = True
@@ -53,15 +62,22 @@ class LogProxy(AuditLog):
             except ContentType.DoesNotExist:
                 result = 'Model:{}, id:{}'.format(user_type_id, user_id)
             else:
-                try:
-                    result = model.objects.get(id=user_id).person.fullname
-                except model.DoesNotExist:
-                    result = f'{model._meta.verbose_name}({user_id})'
+                result = self.user_fullname or f'{model._meta.verbose_name}({user_id})'
         else:
             result = ''
 
         return result
 
+    @property
+    @abstractmethod
+    def user_fullname(self) -> str:
+        """Полное имя пользователя."""
+
+    @property
+    @abstractmethod
+    def user_organization(self) -> str:
+        """Название организации, к которой привязан пользователь."""
+
     @property
     def model_fullname(self):
         """Отображаемое и системное имя модели."""

educommon/audit_log/ui.py

@@ -60,11 +60,5 @@ class ViewChangeWindow(BaseWindow):
         log_record = params['object']
         self.title = '{}: {}'.format(log_record.get_operation_display(), log_record.model_name)
         if log_record.user:
-            self.user_field.value = '{} / {}'.format(
-                log_record.user.person.fullname, log_record.user.person.user.username
-            )
-            unit = getattr(log_record.user, 'unit', None)
-            if unit:
-                self.unit_field.value = unit.short_name
-            else:
-                self.unit_field.value = ''
+            self.user_field.value = f'{log_record.user_fullname} / {log_record.user.username}'
+            self.unit_field.value = log_record.user_organization

educommon/audit_log/utils/__init__.py

@@ -345,28 +345,6 @@ def make_hstore_filter(field, value):
     return result
 
 
-def make_name_filter(field, value):
-    """Создает lookup фильтра по фамилии/имени/отчеству пользователя.
-
-    :param str field: название поля ('firstname', 'surname', 'patronymic').
-    :param str value: значение, по которому фильтруется queryset.
-    """
-    ContentType = apps.get_model('contenttypes', 'ContentType')
-    Employee = apps.get_model('employee', 'Employee')
-    SysAdmin = apps.get_model('sysadmin', 'SysAdmin')
-
-    result = None
-    for model in (Employee, SysAdmin):
-        type_id = ContentType.objects.get_for_model(model).id
-        user_ids = list(model.objects.filter(**{f'person__{field}__icontains': value}).values_list('id', flat=True))
-        qobj = Q(user_id__in=user_ids, user_type_id=type_id)
-        if result:
-            result |= qobj
-        else:
-            result = qobj
-    return result
-
-
 class ModelRegistry:
     """Реестр моделей Django по имени таблицы.
 
@@ -447,7 +425,7 @@ def get_audit_log_context(request):
     result = {}
 
     current_user = ioc.get('get_current_user')(request)
-    if current_user:
+    if current_user and current_user.is_authenticated:
         ContentType = apps.get_model('contenttypes', 'ContentType')
 
         result['user_id'] = current_user.id

educommon/utils/ui.py

@@ -339,6 +339,33 @@ class DatetimeFilterCreator:
         return result
 
 
+class FilterByDateStr(_FilterByField):
+    """Фильтр позволяет работать с датой в формате d.m.Y, m.Y, Y."""
+
+    def __init__(self, *args, **kwargs) -> None:
+        kwargs['date_str'] = True
+
+        super().__init__(*args, **kwargs)
+        
+        self._lookup = self._lookup if self._lookup.endswith('__icontains') else f'{self._lookup}__icontains'
+
+    def get_q(self, params: dict) -> Q:
+        """Метод возвращает Q-объект, построенный на основе данных словаря.
+
+        Args:
+            params: Словарь с лукапами.
+        Returns:
+            Q-объект, построенный на основе данных словаря.
+        """
+
+        if self._uid in params:
+            value = '-'.join(params[self._uid].split('.')[::-1])
+
+            return Q(**{self._lookup: value})
+
+        return Q()
+
+
 def switch_window_in_read_only_mode(window):
     """Переводит окно редактирования в режим "Только для чтения".
 

{educommon-3.13.2.dist-info → educommon-3.15.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: educommon
-Version: 3.13.2
+Version: 3.15.0
 Summary: Общая кодовая база для проектов БЦ Образование
 Author-email: BARS Group <education_dev@bars-open.ru>
 Project-URL: Homepage, https://stash.bars-open.ru/projects/EDUBASE/repos/educommon/browse
@@ -33,7 +33,7 @@ Requires-Dist: python-magic==0.4.15
 Requires-Dist: m3-db-utils>=0.3.13
 Requires-Dist: m3-django-compat<2,>=1.10.2
 Requires-Dist: m3-core<3,>=2.2.16
-Requires-Dist: m3-ui<3,>=2.2.40
+Requires-Dist: m3-ui<3,>=2.2.116
 Requires-Dist: m3-objectpack<3,>=2.2.49
 Requires-Dist: m3-simple-report<2,>=1.4.1
 Requires-Dist: m3-spyne-smev<2,>=0.2.4

{educommon-3.13.2.dist-info → educommon-3.15.0.dist-info}/RECORD

@@ -40,18 +40,19 @@ educommon/async_tasks/fixtures/initial_data.json,sha256=d5EGMoCY8CVJL80C8ZaPwVVU
 educommon/async_tasks/migrations/0001_initial.py,sha256=ohWQK9rzMdM6kSWs7IPmlOA5amkWdaWZ7u3MBl1uWd0,5632
 educommon/async_tasks/migrations/0002_load_initial_data.py,sha256=MMLyXnEl9KFb1jYNfDfunwoLrTLyZfSqmcUQUhr2V-M,477
 educommon/async_tasks/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+educommon/audit_log/README.rst,sha256=qz0PxwnAMNnSYMemX_WQzttDA7068YzPc-jHMCSRxDY,2777
 educommon/audit_log/__init__.py,sha256=fNpKUKim4ybYWxSXjJ77G0YsvtFiZcWb0x6SDT3GxMo,2773
-educommon/audit_log/actions.py,sha256=iC9kREnAtaMmBRJLIOcwzATBjceGojeeDUkCd5Po3GM,6231
-educommon/audit_log/app_meta.py,sha256=eIEgpxkZ5MTD6h1j1GrWMxyWdyoKk7rSWzHlQ6UKKEM,399
+educommon/audit_log/actions.py,sha256=vsfoohNC4MOqCmi_WxuIF9jQMgYSR5BUBFaJw3eESC8,7381
+educommon/audit_log/app_meta.py,sha256=2xg9OKRhAFNmE_k10J5nTnFL8CVuI9iPbEBJha_UXsU,309
 educommon/audit_log/apps.py,sha256=A27iSAEWAVr7LmBmexVDrbWm3eQ-zFq1FYGQRClMJVM,6278
 educommon/audit_log/constants.py,sha256=8C1SCiwD1s_ED9C3Hh50LMAnToGvZmF21nrv18hRLEg,903
 educommon/audit_log/helpers.py,sha256=Dp1DvuzVkhD-P37yoXGd1tvXKPJz2ZQzROS97VURrcY,727
 educommon/audit_log/middleware.py,sha256=HkxBh-1RQJnhKqckkXaMbFjJ34WgZGJssbk04wiS3ts,1140
 educommon/audit_log/models.py,sha256=LLKbnpvz89ZzZ__ZDYBXqh_Klp3z_XfSo69s-MsX-6g,13066
 educommon/audit_log/permissions.py,sha256=_0ntlLKUbJ1kYR2_YpgOxYMJNopZkrdIgxgPiHgL780,1273
-educommon/audit_log/proxies.py,sha256=cyNUCt8057S0I6Hj0s02av_-SuUkDVHERd35KzNQEKI,8230
+educommon/audit_log/proxies.py,sha256=IVZSKpeTDTV8AXdblLo1u9yOmecPdzSvVNrgmf-sxBQ,8750
 educommon/audit_log/routers.py,sha256=FF3KLvf6_WWFuZ9VRI8AZyKDfWp_lyd0i6bcVFfIehQ,204
-educommon/audit_log/ui.py,sha256=E0O1JpafNO8oI67u4uKQS_gPE6WpoW-h1ZIPbe5K44w,2584
+educommon/audit_log/ui.py,sha256=wuhNk6itlOuRStro6fINMQoguzuAKZibURFMedSnqCc,2394
 educommon/audit_log/error_log/__init__.py,sha256=lfAIm5GTGQ1-kRFxH1s0agSt2Oeguwj2906XNBC0qH4,97
 educommon/audit_log/error_log/actions.py,sha256=-KSy3RrBsbPWCML-gl5Hl5UGQdEsPZhoKrHq16LRmm8,2305
 educommon/audit_log/management/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -69,7 +70,7 @@ educommon/audit_log/migrations/0009_reinstall_audit_log.py,sha256=c95H2yamWyrCoG
 educommon/audit_log/migrations/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 educommon/audit_log/sql/configure_audit_log.sql,sha256=M3QxNKTZbn-uNRxGDvNxE9iJh1EOQUTIho7rvc3yhlY,1511
 educommon/audit_log/sql/install_audit_log.sql,sha256=SHrZ7WaYxawUKQEpZnj9k4HTU25NvBlxX_POqZ95HU0,14107
-educommon/audit_log/utils/__init__.py,sha256=Mx6yOVUTE5bqoeEmZp4QOvKQg1qG2wTjSvUvzKsEcus,15731
+educommon/audit_log/utils/__init__.py,sha256=FSq-L4wNOrCTqve16c4KruIxTwHZuTh1lNLNgznAcv8,14843
 educommon/audit_log/utils/operations.py,sha256=skxL7wE4Jx1XlNdPx-Pl3SfiZ1G9jBmcZrXKSQDUGzw,2555
 educommon/auth/__init__.py,sha256=xkGJgqQ5QaEU86n6tJV77ux-2bMTAKbjpVYBCDhcS0E,79
 educommon/auth/rbac/__init__.py,sha256=guO7sOX6e1Z-dqptsqXjbnMdgbSdKp2suDKJa5_pdVU,317
@@ -295,7 +296,7 @@ educommon/utils/seqtools.py,sha256=SRPlgn9KB-0cWCESfqeywfsdIbTjUopFmZYbcDQca88,4
 educommon/utils/serializer.py,sha256=R-72kNjLa5izLXy3qLmzrBWDk-feTnJR7FwNRvGG77Y,8653
 educommon/utils/storage.py,sha256=RcWAR7vxc0uZ2PODdpcNoBQGKilSaQnxxGwa0rfwlm8,2887
 educommon/utils/system.py,sha256=34mUlk7OV5pgcxAucWVWe9xQ--I_u40ZByWGLtkoGdQ,2804
-educommon/utils/ui.py,sha256=N_v44tYryB66uZF-k8V5fxsnVds3FMvEFKxMzb8Ph6c,16344
+educommon/utils/ui.py,sha256=ZloCrrZR7kczef4IKH02OZD0olJ-h-EVvplnlp6k6XY,17270
 educommon/utils/db/__init__.py,sha256=b2hyjR6PZgP9E0LFIl8yTHgCOKO7_WEeXPqPNdbqoTg,7624
 educommon/utils/db/postgresql.py,sha256=HvSCxNy6ZuHsohckmNFbWxFBoeCh-AKSRRALAGfjEd0,2786
 educommon/utils/fonts/Arial.ttf,sha256=NcDzVZ2NtWnjbDEJW4pg1EFkPZX1kTneQOI_ragZuDM,275572
@@ -348,7 +349,7 @@ educommon/ws_log/smev/exceptions.py,sha256=VNfzNHlj5Pz8D4979d_msTkxC-RQVoMctsgoJ
 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.13.2.dist-info/METADATA,sha256=7ZDIplBEd913ZsEizOh6ys-LRZQN1Qmv2JGWY0jooV4,2379
-educommon-3.13.2.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
-educommon-3.13.2.dist-info/top_level.txt,sha256=z5fbW7bz_0V1foUm_FGcZ9_MTpW3N1dBN7-kEmMowl4,10
-educommon-3.13.2.dist-info/RECORD,,
+educommon-3.15.0.dist-info/METADATA,sha256=_8hCUYe-OqYdSUa0pDvbkIF4peIPvOZT4_SU0kXkFek,2380
+educommon-3.15.0.dist-info/WHEEL,sha256=1tXe9gY0PYatrMPMDd6jXqjfpz_B-Wqm32CPfRC58XU,91
+educommon-3.15.0.dist-info/top_level.txt,sha256=z5fbW7bz_0V1foUm_FGcZ9_MTpW3N1dBN7-kEmMowl4,10
+educommon-3.15.0.dist-info/RECORD,,