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

educommon/django/db/migration/operations.py

@@ -24,8 +24,7 @@ from django.db.models import (
 )
 
 
-def get_objects_from_fixture(file_path, file_type=None,
-                             use_natural_foreign_keys=False):
+def get_objects_from_fixture(file_path, file_type=None, use_natural_foreign_keys=False):
     """Возвращает генератор объектов из файла фикстуры.
 
     :param basestring file_path: Путь к файлу с данными.
@@ -36,16 +35,14 @@ def get_objects_from_fixture(file_path, file_type=None,
     :rtype: generator
     """
     if file_type is None:
-        file_type = file_path[file_path.rfind('.') + 1:]
+        file_type = file_path[file_path.rfind('.') + 1 :]
         if file_type not in ('json', 'xml', 'yaml'):
             raise ValueError('Неподдерживаемый тип файла ' + file_path)
 
     with open(file_path, 'r') as infile:
-        with closing(deserialize(
-            file_type,
-            infile.read(),
-            use_natural_foreign_keys=use_natural_foreign_keys
-        )) as objects:
+        with closing(
+            deserialize(file_type, infile.read(), use_natural_foreign_keys=use_natural_foreign_keys)
+        ) as objects:
             for obj in objects:
                 yield obj
 
@@ -69,11 +66,12 @@ def correct_sequence_value(model, field='id', conn=connection):
     cursor = conn.cursor()
 
     cursor.execute(
-        "SELECT setval(pg_get_serial_sequence(%s,%s), %s)", (
+        'SELECT setval(pg_get_serial_sequence(%s,%s), %s)',
+        (
             model._meta.db_table,
             model._meta.get_field(field).column,
             max_id,
-        )
+        ),
     )
 
 
@@ -86,8 +84,7 @@ class LoadFixture(Operation):
 
     atomic = True
 
-    def __init__(self, file_path, force=False, file_type=None,
-                 use_natural_foreign_keys=False):
+    def __init__(self, file_path, force=False, file_type=None, use_natural_foreign_keys=False):
         """Инициализация экземпляра класса.
 
         :param str file_path: Путь к файлу.
@@ -105,8 +102,9 @@ class LoadFixture(Operation):
     def state_forwards(self, app_label, state):
         pass
 
-    def database_forwards(self, app_label, schema_editor, from_state,
-                          to_state):
+    def database_forwards(self, app_label, schema_editor, from_state, to_state):
+        """Выполняет миграцию для выбранного приложения."""
+
         @contextmanager
         def replace_model_loader():
             _get_model = python_serializer_module._get_model
@@ -142,8 +140,8 @@ class CorrectSequence(Operation):
     def state_forwards(self, app_label, state):
         pass
 
-    def database_forwards(self, app_label, schema_editor, from_state,
-                          to_state):
+    def database_forwards(self, app_label, schema_editor, from_state, to_state):
+        """Выполняет миграцию для выбранного приложения."""
         db_alias = schema_editor.connection.alias
         model = to_state.apps.get_model(app_label, self.model_name)
         if self.allow_migrate_model(db_alias, model) or self.force:
@@ -155,8 +153,7 @@ class CreateSchema(Operation):
 
     reversible = True
 
-    def __init__(self, schema_name, owner=None, aliases=None,
-                 cascade_drop=False):
+    def __init__(self, schema_name, owner=None, aliases=None, cascade_drop=False):
         """Инициализация экземпляра.
 
         :param schema_name: Имя схемы.
@@ -178,16 +175,16 @@ class CreateSchema(Operation):
     def state_backward(self, app_label, state):
         pass
 
-    def database_forwards(self, app_label, schema_editor, from_state,
-                          to_state):
+    def database_forwards(self, app_label, schema_editor, from_state, to_state):
+        """Выполняет миграцию для выбранного приложения."""
         if not self.aliases or schema_editor.connection.alias in self.aliases:
             sql = 'CREATE SCHEMA IF NOT EXISTS ' + self.schema_name
             if self.owner:
                 sql += ' AUTHORIZATION ' + self.owner
             schema_editor.execute(sql)
 
-    def database_backwards(self, app_label, schema_editor, from_state,
-                           to_state):
+    def database_backwards(self, app_label, schema_editor, from_state, to_state):
+        """Откатывает миграцию для выбранного приложения."""
         if not self.aliases or schema_editor.connection.alias in self.aliases:
             sql = 'DROP SCHEMA IF EXISTS ' + self.schema_name
             if self.cascade_drop:
@@ -196,41 +193,25 @@ class CreateSchema(Operation):
 
 
 class _AnotherAppMixin:
-
     def __init__(self, *args, **kwargs):
         self.__app_label = kwargs.pop('app_label', None)
 
         super().__init__(*args, **kwargs)
 
     def state_forwards(self, app_label, state):
-        super().state_forwards(
-            self.__app_label or app_label,
-            state
-        )
-
-    def database_forwards(
-        self, app_label, schema_editor, from_state, to_state
-    ):
-        super().database_forwards(
-            self.__app_label or app_label,
-            schema_editor,
-            from_state,
-            to_state
-        )
-
-    def database_backwards(
-        self, app_label, schema_editor, from_state, to_state
-    ):
-        super().database_backwards(
-            self.__app_label or app_label,
-            schema_editor,
-            from_state,
-            to_state
-        )
+        """Применяет изменение к заданному приложению или текущему."""
+        super().state_forwards(self.__app_label or app_label, state)
 
+    def database_forwards(self, app_label, schema_editor, from_state, to_state):
+        """Выполняет миграцию для выбранного приложения."""
+        super().database_forwards(self.__app_label or app_label, schema_editor, from_state, to_state)
+
+    def database_backwards(self, app_label, schema_editor, from_state, to_state):
+        """Откатывает миграцию для выбранного приложения."""
+        super().database_backwards(self.__app_label or app_label, schema_editor, from_state, to_state)
 
-class AddField(_AnotherAppMixin, AddField):
 
+class AddField(_AnotherAppMixin, AddField):
     """Операция добавления поля в модель с поддержкой других приложений.
 
     Имя приложения можно указать в аргументе :arg:`app_label`.
@@ -238,7 +219,6 @@ class AddField(_AnotherAppMixin, AddField):
 
 
 class AlterField(_AnotherAppMixin, AlterField):
-
     """Операция изменения поля в модели с поддержкой других приложений.
 
     Имя приложения можно указать в аргументе :arg:`app_label`.
@@ -246,7 +226,6 @@ class AlterField(_AnotherAppMixin, AlterField):
 
 
 class RemoveField(_AnotherAppMixin, RemoveField):
-
     """Операция удаления поля в модели с поддержкой других приложений.
 
     Имя приложения можно указать в аргументе :arg:`app_label`.
@@ -254,7 +233,6 @@ class RemoveField(_AnotherAppMixin, RemoveField):
 
 
 class RenameField(_AnotherAppMixin, RenameField):
-
     """Операция переименования поля в модели с поддержкой других приложений.
 
     Имя приложения можно указать в аргументе :arg:`app_label`.

educommon/django/db/mixins/__init__.py

@@ -1,4 +1,5 @@
 """Классы-примеси для моделей Django."""
+
 from django.db import (
     models,
 )
@@ -12,7 +13,6 @@ from m3_django_compat.exceptions import (
 
 
 class DeferredActionsMixin(models.Model):
-
     """Класс-примесь для выполнения отложенных действий в моделях.
 
     Позволяет выполнять действия, оформленные в виде callable-объектов,
@@ -36,7 +36,7 @@ class DeferredActionsMixin(models.Model):
         abstract = True
 
     def __init__(self, *args, **kwargs):  # noqa: D107
-        super(DeferredActionsMixin, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
         self.__pre_save_actions = []
         self.__post_save_actions = []
@@ -74,7 +74,9 @@ class DeferredActionsMixin(models.Model):
         соответственно.
         """
         self.__execute_actions(self.__pre_save_actions)
-        super(DeferredActionsMixin, self).save(*args, **kwargs)
+
+        super().save(*args, **kwargs)
+
         self.__execute_actions(self.__post_save_actions)
 
     @atomic
@@ -86,8 +88,11 @@ class DeferredActionsMixin(models.Model):
         соответственно.
         """
         self.__execute_actions(self.__pre_delete_actions)
-        result = super(DeferredActionsMixin, self).delete(*args, **kwargs)
+
+        result = super().delete(*args, **kwargs)
+
         self.__execute_actions(self.__post_delete_actions)
+
         return result
 
     @atomic
@@ -99,13 +104,15 @@ class DeferredActionsMixin(models.Model):
         соответственно.
         """
         self.__execute_actions(self.__pre_delete_actions)
-        result = super(DeferredActionsMixin, self).safe_delete(*args, **kwargs)
+
+        result = super().safe_delete(*args, **kwargs)
+
         self.__execute_actions(self.__post_delete_actions)
+
         return result
 
 
 class DeleteOnSaveMixin(models.Model):
-
     """Примесь для удаления объектов до/после сохранения модели.
 
     Функционал данной примеси актуален при валидации моделей. В некоторых
@@ -120,7 +127,7 @@ class DeleteOnSaveMixin(models.Model):
     """
 
     def __init__(self, *args, **kwargs):
-        super(DeleteOnSaveMixin, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
         # Список объектов, подлежащих удалению после сохранения self
         self.__objects_for_delete_before_save = set()
@@ -176,7 +183,7 @@ class DeleteOnSaveMixin(models.Model):
 
         delete_objects(self.__objects_for_delete_before_save)
 
-        super(DeleteOnSaveMixin, self).save(*args, **kwargs)
+        super().save(*args, **kwargs)
 
         delete_objects(self.__objects_for_delete_after_save)
 
@@ -185,7 +192,6 @@ class DeleteOnSaveMixin(models.Model):
 
 
 class StringFieldsCleanerMixin(models.Model):
-
     """Примесь для удаления из строковых полей модели лишних пробелов.
 
     Во всех текстовых полях модели удаляет пробельные символы в начале и конце
@@ -222,7 +228,7 @@ class StringFieldsCleanerMixin(models.Model):
 
                 setattr(self, field.attname, field_value)
 
-        return super(StringFieldsCleanerMixin, self).clean_fields(exclude)
+        return super().clean_fields(exclude)
 
     class Meta:
         abstract = True

educommon/django/db/mixins/date_interval.py

@@ -30,12 +30,12 @@ from educommon.utils.date import (
 
 
 class BaseIntervalMeta(models.base.ModelBase):
-
     """Базовый метакласс для примесей *IntervalMixin.
 
     Добавляет к создаваемой модели поля, содержащие границы интервала. Имена
     полей задаются в атрибуте interval_field_names.
     """
+
     # тип поля модели, определяется в потомке
     _interval_bound_field_type = None
 
@@ -62,42 +62,34 @@ class BaseIntervalMeta(models.base.ModelBase):
         return result
 
     def __new__(cls, name, bases, attrs):
-        if (
-            cls._mixin_stay(bases) and
-            (
-                # поля с границами интервала создаются только если модель не
-                # абстрактная.
-                'Meta' not in attrs or
-                not hasattr(attrs['Meta'], 'abstract') or
-                not attrs['Meta'].abstract
-            )
+        if cls._mixin_stay(bases) and (
+            # поля с границами интервала создаются только если модель не
+            # абстрактная.
+            'Meta' not in attrs or not hasattr(attrs['Meta'], 'abstract') or not attrs['Meta'].abstract
         ):
-            interval_field_names = cls.__get_attr(
-                'interval_field_names', attrs, bases, cls.interval_field_names
-            )
+            interval_field_names = cls.__get_attr('interval_field_names', attrs, bases, cls.interval_field_names)
 
             # Добавление полей, хранящих границы интервала
-            for field_name, verbose_name in zip(
-                interval_field_names, ('Начало интервала', 'Конец интервала')
-            ):
+            for field_name, verbose_name in zip(interval_field_names, ('Начало интервала', 'Конец интервала')):
                 field = cls.__get_attr(field_name, attrs, bases)
                 if field is Undefined:
                     attrs[field_name] = cls._interval_bound_field_type(
                         name=field_name,
-                        blank=True, null=True,
+                        blank=True,
+                        null=True,
                         verbose_name=verbose_name,
                     )
 
-        return super(BaseIntervalMeta, cls).__new__(cls, name, bases, attrs)
+        return super().__new__(cls, name, bases, attrs)
 
 
 class DateIntervalMeta(BaseIntervalMeta):
-
     """Метакласс для примеси DateIntervalMixin.
 
     Добавляет к создаваемой модели поля дат, содержащие границы интервала.
     Имена полей задаются в атрибуте interval_field_names.
     """
+
     # тип полей модели, которые будет созданы
     _interval_bound_field_type = models.DateField
     # названия полей по умолчанию
@@ -109,19 +101,16 @@ class DateIntervalMeta(BaseIntervalMeta):
 
         :rtype bool
         """
-        return (
-            'DateIntervalMixin' in globals() and
-            any(issubclass(base, DateIntervalMixin) for base in bases)
-        )
+        return 'DateIntervalMixin' in globals() and any(issubclass(base, DateIntervalMixin) for base in bases)
 
 
 class DateTimeIntervalMeta(BaseIntervalMeta):
-
     """Метакласс для примеси DateTimeIntervalMixin.
 
     Добавляет к создаваемой модели поля дат со временем, содержащие
     границы интервала. Имена полей задаются в атрибуте interval_field_names.
     """
+
     # тип полей модели, которые будет созданы
     _interval_bound_field_type = models.DateTimeField
     # названия полей по умолчанию
@@ -133,14 +122,10 @@ class DateTimeIntervalMeta(BaseIntervalMeta):
 
         :rtype bool
         """
-        return (
-            'DateTimeIntervalMixin' in globals() and
-            any(issubclass(base, DateTimeIntervalMixin) for base in bases)
-        )
+        return 'DateTimeIntervalMixin' in globals() and any(issubclass(base, DateTimeIntervalMixin) for base in bases)
 
 
 class BaseIntervalMixin(models.Model):
-
     """Базовый класс для примесей к моделям, добавляющих интервал дат.
 
     Содержит два поля: date_from (дата начала интервала) и date_to (дата
@@ -165,18 +150,17 @@ class BaseIntervalMixin(models.Model):
 
     Используется для проверки пересечения диапазонов.
     """
+
     @classmethod
     def get_current_date(cls):
         """Возвращает текущую дату.
 
         :rtype: datetime.datetime or datetime.date
         """
-        raise NotImplemented
+        raise NotImplementedError
 
     @classmethod
-    def get_date_in_intervals_filter(cls, day=None, lookup=None,
-                                     include_lower_bound=True,
-                                     include_upper_bound=True):
+    def get_date_in_intervals_filter(cls, day=None, lookup=None, include_lower_bound=True, include_upper_bound=True):
         """Возвращает фильтр для выборки записей по указанной дате.
 
         Условия фильтра включают записи, в интервал которых входит
@@ -225,6 +209,7 @@ class BaseIntervalMixin(models.Model):
             to_filter |= Q(**{to_lookup + '__isnull': True})
 
         result = from_filter & to_filter
+
         return result
 
     @classmethod
@@ -233,12 +218,7 @@ class BaseIntervalMixin(models.Model):
 
     @classmethod
     def get_intersection_daterange_filter(
-        cls,
-        date_begin=None,
-        date_end=None,
-        lookup=None,
-        include_lower_bound=True,
-        include_upper_bound=True
+        cls, date_begin=None, date_end=None, lookup=None, include_lower_bound=True, include_upper_bound=True
     ):
         """Метод возвращает фильтр для выборки записей, попадающих в интервал.
 
@@ -268,11 +248,7 @@ class BaseIntervalMixin(models.Model):
 
         .. code-block:: python
             :caption: Пример использования
-            query = model.objects.filter(
-                model.get_intersection_daterange_filter(
-                    date_begin, date_end
-                )
-            )
+            query = model.objects.filter(model.get_intersection_daterange_filter(date_begin, date_end))
 
         :params date_begin: Дата начала интервала.
         :type date_begin: datetime.datetime
@@ -305,9 +281,7 @@ class BaseIntervalMixin(models.Model):
         # Предполагается, что в интервалах дат дата окончания находится
         # справа по оси времени от даты начала или равна. Если будет наоборот,
         # то результат может оказаться не верным
-        assert date_end >= date_begin, (
-            'Дата окончания должна быть больше или равна дате начала'
-        )
+        assert date_end >= date_begin, 'Дата окончания должна быть больше или равна дате начала'
 
         from_name, to_name = cls.interval_field_names
         if lookup is not None:
@@ -331,6 +305,7 @@ class BaseIntervalMixin(models.Model):
             to_filter |= Q(**{to_lookup + '__isnull': True})
 
         result = from_filter & to_filter
+
         return result
 
     def is_date_in_interval(self, day):
@@ -343,12 +318,19 @@ class BaseIntervalMixin(models.Model):
         assert isinstance(day, (date, datetime)), type(day)
         date_from, date_to = self.interval_range
         result = (
-            date_from is None and date_to is None or
-            date_from is None and date_to is not None and day <= date_to or
-            date_from is not None and date_to is None and day >= date_from or
-            date_from is not None and date_to is not None and
-            date_from <= day <= date_to
+            date_from is None
+            and date_to is None
+            or date_from is None
+            and date_to is not None
+            and day <= date_to
+            or date_from is not None
+            and date_to is None
+            and day >= date_from
+            or date_from is not None
+            and date_to is not None
+            and date_from <= day <= date_to
         )
+
         return result
 
     def is_intersected_with(self, date_from, date_to):
@@ -400,6 +382,7 @@ class BaseIntervalMixin(models.Model):
             opts.get_field(date_from_name).verbose_name.capitalize(),
             opts.get_field(date_to_name).verbose_name.lower(),
         )
+
         return result
 
     def interval_intersected_error_message(self, others=None):
@@ -419,9 +402,9 @@ class BaseIntervalMixin(models.Model):
 
         date_from = getattr(self, date_from_name)
 
-        prev_intervals = self.__class__.objects.filter(
-            **{'{}__lt'.format(date_to_name): date_from}
-        ).order_by('-{}'.format(date_to_name))
+        prev_intervals = self.__class__.objects.filter(**{'{}__lt'.format(date_to_name): date_from}).order_by(
+            '-{}'.format(date_to_name)
+        )
 
         return prev_intervals[0] if prev_intervals else None
 
@@ -466,9 +449,9 @@ class BaseIntervalMixin(models.Model):
 
         date_to = getattr(self, date_to_name)
 
-        next_intervals = self.__class__.objects.filter(
-            **{'{}__gt'.format(date_from_name): date_to}
-        ).order_by(date_from_name)
+        next_intervals = self.__class__.objects.filter(**{'{}__gt'.format(date_from_name): date_to}).order_by(
+            date_from_name
+        )
 
         return next_intervals[0] if next_intervals else None
 
@@ -477,28 +460,20 @@ class BaseIntervalMixin(models.Model):
         errors = {}
 
         try:
-            super(BaseIntervalMixin, self).clean()
+            super().clean()
         except ValidationError as error:
             errors = error.update_error_dict(errors)
 
         date_from, date_to = self.interval_range
 
         # Дата начала интервала должна быть раньше даты окончания
-        if (
-            date_from is not None and
-            date_to is not None and
-            date_from > date_to
-        ):
-            errors.setdefault(NON_FIELD_ERRORS, []).append(
-                self.interval_dates_error_message()
-            )
+        if date_from is not None and date_to is not None and date_from > date_to:
+            errors.setdefault(NON_FIELD_ERRORS, []).append(self.interval_dates_error_message())
         else:
             # Проверка пересения интервалов
             others = self.get_intersected_query()
             if others:
-                errors.setdefault(NON_FIELD_ERRORS, []).append(
-                    self.interval_intersected_error_message(others)
-                )
+                errors.setdefault(NON_FIELD_ERRORS, []).append(self.interval_intersected_error_message(others))
 
         if errors:
             raise ValidationError(errors)
@@ -582,7 +557,6 @@ class DateTimeIntervalMixin(BaseIntervalMixin, metaclass=DateTimeIntervalMeta):
 
 
 class ActualObjectsManager(Manager):
-
     """Менеджер для интервальной модели.
 
     Отфильтровывает все объекты, в интервал которых входит текущая дата.
@@ -591,9 +565,7 @@ class ActualObjectsManager(Manager):
     def contribute_to_class(self, model, name):
         assert issubclass(model, BaseIntervalMixin), type(model)
 
-        super(ActualObjectsManager, self).contribute_to_class(model, name)
+        super().contribute_to_class(model, name)
 
     def get_queryset(self):
-        return super(ActualObjectsManager, self).get_queryset().filter(
-            self.model.get_date_in_intervals_filter()
-        )
+        return super().get_queryset().filter(self.model.get_date_in_intervals_filter())