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

educommon/django/db/mixins/validation.py

@@ -47,8 +47,11 @@ class QuerySet(DjangoQuerySet):
     """
 
     def create(self, **kwargs):
-        # Копипаста метода из Django 1.4 с добавлением вызова full_clean().
-        # Обусловлено невозможностью расширения метода.
+        """Создаёт объект модели.
+
+        Копипаста метода из Django 1.4 с добавлением вызова full_clean().
+        Обусловлено невозможностью расширения метода.
+        """
         if self.model.clean_and_save_inside_transaction:
             cm = atomic()
         else:
@@ -59,14 +62,16 @@ class QuerySet(DjangoQuerySet):
             obj.full_clean()
             self._for_write = True
             obj.save(force_insert=True, using=self.db)
+
         return obj
 
     def get_or_create(self, **kwargs):
-        # Копипаста метода из Django 1.4 с добавлением вызова full_clean().
-        # Обусловлено невозможностью расширения метода.
-        assert kwargs, (
-            'get_or_create() must be passed at least one keyword argument'
-        )
+        """Ищет или создаёт объект модели.
+
+        Копипаста метода из Django 1.4 с добавлением вызова full_clean().
+        Обусловлено невозможностью расширения метода.
+        """
+        assert kwargs, 'get_or_create() must be passed at least one keyword argument'
         defaults = kwargs.pop('defaults', {})
         lookup = kwargs.copy()
         for f in getattr(self.model, '_meta').fields:
@@ -77,9 +82,7 @@ class QuerySet(DjangoQuerySet):
             return self.get(**lookup), False
         except self.model.DoesNotExist:
             try:
-                params = dict(
-                    [(k, v) for k, v in kwargs.items() if '__' not in k]
-                )
+                params = dict([(k, v) for k, v in kwargs.items() if '__' not in k])
                 params.update(defaults)
                 obj = self.model(**params)
                 obj.full_clean()
@@ -146,7 +149,6 @@ class ModelValidationMixin(models.Model):
 
         # models.py основной системы
         class MyModel(BaseModel):
-
             # Поле обязательно в основной системе
             read_rules = models.BooleanField(...)
 
@@ -157,12 +159,11 @@ class ModelValidationMixin(models.Model):
                 RequiredBooleanValidator('read_rules'),
             ]
 
+
         # extenders.py в плагине
         from app.models import MyModel
 
-        MyModel.validators.append(
-            RequiredBooleanValidator('read_rules_plugin')
-        )
+        MyModel.validators.append(RequiredBooleanValidator('read_rules_plugin'))
     """
 
     #: Признак использования транзакций при проверке и сохранении.
@@ -182,12 +183,11 @@ class ModelValidationMixin(models.Model):
     validators = []
 
     def __init__(self, *args, **kwargs):
-        super(ModelValidationMixin, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
 
-        assert not self.validators or all(
-            isinstance(validator, IModelValidator)
-            for validator in self.validators
-        ), self.validators
+        assert not self.validators or all(isinstance(validator, IModelValidator) for validator in self.validators), (
+            self.validators
+        )
 
         self.__set_valid_flag(False)
 
@@ -205,7 +205,7 @@ class ModelValidationMixin(models.Model):
         errors = defaultdict(list)
 
         try:
-            super(ModelValidationMixin, self).clean()
+            super().clean()
         except ValidationError as error:
             errors.update(error.update_error_dict(errors))
 
@@ -218,7 +218,8 @@ class ModelValidationMixin(models.Model):
             # Фрейм, в котором сгенерировано исключение, будет последним.
             error_frame = inspect.getinnerframes(tb)[-1][0]
             descriptior_types = (
-                ForwardOneToOneDescriptor, ReverseOneToOneDescriptor,
+                ForwardOneToOneDescriptor,
+                ReverseOneToOneDescriptor,
             )
             # Источником исключения может быть модель, кварисет или дескриптор
             exception_source = error_frame.f_locals['self']
@@ -240,7 +241,7 @@ class ModelValidationMixin(models.Model):
                     model_name = model_or_query._meta.verbose_name
                 elif isinstance(model_or_query, models.QuerySet):
                     model_name = model_or_query.model._meta.verbose_name
-                message = 'Указанный объект %s не существует.' % model_name
+                message = f'Указанный объект {model_name} не существует.'
 
             errors.update({NON_FIELD_ERRORS: message})
 
@@ -271,7 +272,7 @@ class ModelValidationMixin(models.Model):
         pre_clean.send(sender=self.__class__, instance=self, errors=errors)
 
         try:
-            super(ModelValidationMixin, self).full_clean(exclude)
+            super().full_clean(exclude)
         except ValidationError as error:
             errors.update(error.update_error_dict(errors))
 
@@ -287,13 +288,12 @@ class ModelValidationMixin(models.Model):
         """После сохранения объекта снимает отметку о выполнении валидации."""
         if not self.ready_to_save:
             raise AssertionError(
-                'Attempt to save data without validation '
-                '(model {}.{})'.format(
+                'Attempt to save data without validation (model {}.{})'.format(
                     self.__class__.__module__, self.__class__.__name__
                 )
             )
 
-        super(ModelValidationMixin, self).save(*args, **kwargs)
+        super().save(*args, **kwargs)
 
         # Перед следующим сохранением нужно будет снова вызвать full_clean
         self.__set_valid_flag(False)

educommon/django/db/model_view/__init__.py

@@ -4,6 +4,7 @@
 является формирование какого-либо представления (HTML, JSON и т.п.) на основе
 объекта модели.
 """
+
 from abc import (
     ABCMeta,
     abstractmethod,
@@ -64,6 +65,8 @@ class ModelView(metaclass=ABCMeta):
     @abstractmethod
     def get_view(self, objects):
         """Возвращает представление для указанных объектов."""
+
+
 # -----------------------------------------------------------------------------
 # Извлечение данных из объектов
 
@@ -77,7 +80,6 @@ class DataExtractor(metaclass=ABCMeta):
 
 
 class Text(DataExtractor):
-
     def __init__(self, text):
         self._text = text
 
@@ -155,10 +157,9 @@ class FieldChoiceValue(DataExtractor):
         except AttributeError:
             return ''
         else:
-            return force_str(
-                dict(field.flatchoices).get(value, value),
-                strings_only=True
-            )
+            return force_str(dict(field.flatchoices).get(value, value), strings_only=True)
+
+
 # -----------------------------------------------------------------------------
 
 
@@ -174,13 +175,14 @@ class HtmlTableView(ModelView):
       class SubjectOffice(models.Model):
           subject = models.ForeignKey(
               'subject.Subject',
-              verbose_name="Предмет",
+              verbose_name='Предмет',
           )
           office = models.ForeignKey(
               'office.Office',
-              verbose_name="Аудитория",
+              verbose_name='Аудитория',
           )
 
+
       subject_office_view = HtmlTableView(
           model='subject.SubjectOffice',
           columns=(
@@ -213,7 +215,7 @@ class HtmlTableView(ModelView):
     _columns = ()
 
     def __init__(self, model, columns, *args, **kwargs):
-        super(HtmlTableView, self).__init__(model, *args, **kwargs)
+        super().__init__(model, *args, **kwargs)
 
         self._columns = columns
 
@@ -229,20 +231,14 @@ class HtmlTableView(ModelView):
         if all(not column.get('header') for column in self._columns):
             return None
 
-        return tuple(
-            column['header'].get(model)
-            for column in self._columns
-        )
+        return tuple(column['header'].get(model) for column in self._columns)
 
     def _get_body_data(self, objects):
         """Возвращает данные для ячеек тела таблицы.
 
         :rtype: tuple
         """
-        return tuple(
-            tuple(column['data'].get(obj) for column in self._columns)
-            for obj in objects
-        )
+        return tuple(tuple(column['data'].get(obj) for column in self._columns) for obj in objects)
 
     def get_view(self, objects):
         """Возвращает строку с HTML-таблицей, содержащей данные объектов.
@@ -271,6 +267,8 @@ class HtmlTableView(ModelView):
                 body=self._get_body_data(objects),
             ),
         )
+
+
 # -----------------------------------------------------------------------------
 
 
@@ -315,8 +313,7 @@ class ModelViewRegistry:
                 # Сравниваем приоритеты представлений
                 if registered_view.priority == view.priority:
                     raise ValueError(
-                        'Для модели {} уже зарегистрировано '
-                        'представление {} с приоритетом {}.'.format(
+                        'Для модели {} уже зарегистрировано представление {} с приоритетом {}.'.format(
                             key, view, view.priority
                         )
                     )
@@ -342,10 +339,9 @@ class ModelViewRegistry:
         elif self._default_view:
             return self._default_view
         else:
-            raise ValueError(
-                'Для модели {} не зарегистрировано представление.'
-                .format(key)
-            )
+            raise ValueError('Для модели {} не зарегистрировано представление.'.format(key))
+
+
 # -----------------------------------------------------------------------------
 
 

educommon/django/db/models.py

@@ -27,7 +27,6 @@ class BaseModel(
     ReprStrPreModelMixin,
     BaseObjectModel,
 ):
-
     """Базовый класс для всех моделей системы."""
 
     class Meta:
@@ -35,7 +34,6 @@ class BaseModel(
 
 
 class ReadOnlyMixin(models.Model):
-
     """Класс-примесь для моделей с записями только для чтения.
 
     В основной модели должны быть реализованы два метода:
@@ -49,26 +47,29 @@ class ReadOnlyMixin(models.Model):
     об ошибке. Параметр delete определяет операцию (False - изменение, True -
     удаление).
     """
+
     def _check_read_only(self, delete):
+        """Вызывает исключение, если объект защищён от изменений или удаления."""
         if self.is_read_only():
-            raise ApplicationLogicException(
-                self.get_read_only_error_message(delete=delete)
-            )
+            raise ApplicationLogicException(self.get_read_only_error_message(delete=delete))
 
     def safe_delete(self, *args, **kwargs):
+        """Удаляет объект, если он не помечен как только для чтения."""
         self._check_read_only(delete=True)
 
-        return super(ReadOnlyMixin, self).safe_delete(*args, **kwargs)
+        return super().safe_delete(*args, **kwargs)
 
     def delete(self, *args, **kwargs):
+        """Удаляет объект, если он не помечен как только для чтения."""
         self._check_read_only(delete=True)
 
-        super(ReadOnlyMixin, self).delete(*args, **kwargs)
+        super().delete(*args, **kwargs)
 
     def save(self, *args, **kwargs):
+        """Сохраняет объект, если он не помечен как только для чтения."""
         self._check_read_only(delete=False)
 
-        super(ReadOnlyMixin, self).save(*args, **kwargs)
+        super().save(*args, **kwargs)
 
     class Meta:
         abstract = True

educommon/django/db/observer.py

@@ -43,7 +43,7 @@ class ModelObserverBase(metaclass=SingletonMeta):
                return model  in self._observables
 
            def _create_context(self, instance):
-               result = super(OriginalObjectMixin, self)._create_context(
+               result = super()._create_context(
                    instance
                )
 
@@ -89,7 +89,6 @@ class ModelObserverBase(metaclass=SingletonMeta):
            уничтожение сборщиком мусора.
         """
 
-    
     def _create_context(self, instance):
         """Возвращает контекст для экземпляра модели.
 
@@ -99,6 +98,7 @@ class ModelObserverBase(metaclass=SingletonMeta):
         """
         context = self.Context()
         self._contexts[context] = instance
+
         return context
 
     def _get_context(self, instance):
@@ -135,6 +135,7 @@ class ModelObserverBase(metaclass=SingletonMeta):
             def inner(instance, sender, **kwargs):
                 if handler.__self__._is_observable(sender):
                     handler(instance=instance, sender=sender, **kwargs)
+
             return inner
 
         pre_save.connect(wrapper(self.__pre_save_handler), weak=False)
@@ -170,19 +171,11 @@ class ModelObserverBase(metaclass=SingletonMeta):
             context = self._get_context(instance)
 
         if hasattr(self, 'pre_save'):
-            self.pre_save(
-                instance=instance,
-                context=context,
-                **kwargs
-            )
+            self.pre_save(instance=instance, context=context, **kwargs)
 
     def __post_save_handler(self, instance, **kwargs):
         if hasattr(self, 'post_save'):
-            self.post_save(
-                instance=instance,
-                context=self._get_context(instance),
-                **kwargs
-            )
+            self.post_save(instance=instance, context=self._get_context(instance), **kwargs)
 
         self._remove_context(instance)
 
@@ -193,19 +186,11 @@ class ModelObserverBase(metaclass=SingletonMeta):
             context = self._get_context(instance)
 
         if hasattr(self, 'pre_delete'):
-            self.pre_delete(
-                instance=instance,
-                context=context,
-                **kwargs
-            )
+            self.pre_delete(instance=instance, context=context, **kwargs)
 
     def __post_delete_handler(self, instance, **kwargs):
         if hasattr(self, 'post_delete'):
-            self.post_delete(
-                instance=instance,
-                context=self._get_context(instance),
-                **kwargs
-            )
+            self.post_delete(instance=instance, context=self._get_context(instance), **kwargs)
 
         self._remove_context(instance)
 
@@ -221,10 +206,7 @@ class ModelDescendantsObserverMixin:
     """Класс примесь для наблюдения за моделями и их потомками."""
 
     def _is_observable(self, model):
-        return any(
-            model is observable or issubclass(model, observable)
-            for observable in self._observables
-        )
+        return any(model is observable or issubclass(model, observable) for observable in self._observables)
 
 
 class OriginalObjectMixin:
@@ -240,7 +222,7 @@ class OriginalObjectMixin:
     __empty = _Empty()
 
     def _create_context(self, instance):
-        result = super(OriginalObjectMixin, self)._create_context(instance)
+        result = super()._create_context(instance)
 
         if instance.pk is None:
             result.original = None