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

educommon/report/utils.py

@@ -39,10 +39,7 @@ def get_cell_bounds(section, row_index, column_index):
     """
     merged_ranges = section.writer.wtsheet.merged_ranges
     for first_row, last_row, first_column, last_column in merged_ranges:
-        if (
-            first_row <= row_index <= last_row and
-            first_column <= column_index <= last_column
-        ):
+        if first_row <= row_index <= last_row and first_column <= column_index <= last_column:
             return first_row, last_row, first_column, last_column
 
     return row_index, row_index, column_index, column_index
@@ -69,13 +66,8 @@ def get_cell_width(section, row_index, column_index):
 
     :rtype: int
     """
-    _, _, first_column, last_column = get_cell_bounds(
-        section, row_index, column_index
-    )
-    return sum(
-        section.writer.wtsheet.col(i).width
-        for i in range(first_column, last_column + 1)
-    )
+    _, _, first_column, last_column = get_cell_bounds(section, row_index, column_index)
+    return sum(section.writer.wtsheet.col(i).width for i in range(first_column, last_column + 1))
 
 
 def get_cell_height(section, row_index, column_index):
@@ -95,17 +87,11 @@ def get_cell_height(section, row_index, column_index):
     :returns: Высоту ячейки в `твипах <https://goo.gl/hfUW7x>`_.
     :rtype: int
     """
-    first_row, last_row, _, _ = get_cell_bounds(
-        section, row_index, column_index
-    )
-    return sum(
-        section.writer.wtsheet.row(i).height
-        for i in range(first_row, last_row + 1)
-    )
+    first_row, last_row, _, _ = get_cell_bounds(section, row_index, column_index)
+    return sum(section.writer.wtsheet.row(i).height for i in range(first_row, last_row + 1))
 
 
-def adjust_row_height(section, row_idx, col_idx, text, font,
-                      adjusted_row_index=None):
+def adjust_row_height(section, row_idx, col_idx, text, font, adjusted_row_index=None):
     """Увеличивает высоту строки, если необходимо.
 
     Высота строки устанавливается такая, чтобы текст `text`
@@ -135,6 +121,7 @@ def adjust_row_height(section, row_idx, col_idx, text, font,
         ячейки будет увеличена равномерно. Номер указывается относительно
         ячейки, нумерация начинается с нуля.
     """
+
     def get_text_height(column_width):
         """Вычисляет высоту строки отчета в зависимости от текста."""
         # Т.к. высота и ширина ячейки измеряется в единицах относительно
@@ -145,9 +132,7 @@ def adjust_row_height(section, row_idx, col_idx, text, font,
         # DEFAULT_CHAR_SIZE * 0.8 определяет ширину отступов слева и справа (в
         # сумме, а не каждого отступа по отдельности). Источник точной
         # информации об отступах в ячейке найти не удалось.
-        width_in_chars = (
-            int(column_width - DEFAULT_CHAR_SIZE * 0.8) // DEFAULT_CHAR_SIZE
-        )
+        width_in_chars = int(column_width - DEFAULT_CHAR_SIZE * 0.8) // DEFAULT_CHAR_SIZE
 
         str_width_px, str_height_px = normal_font.getsize('0' * width_in_chars)
 
@@ -155,17 +140,13 @@ def adjust_row_height(section, row_idx, col_idx, text, font,
         _, choosen_font_height_px = font.getsize('0')
         height_scale = (choosen_font_height_px * 1.0) / str_height_px
 
-        rows_count = len(
-            split_text(text, font, str_width_px)
-        )
+        rows_count = len(split_text(text, font, str_width_px))
 
         height = int(rows_count * height_scale * DEFAULT_CHAR_SIZE)
 
         return height
 
-    first_row, last_row, first_column, last_column = get_cell_bounds(
-        section, row_idx, col_idx
-    )
+    first_row, last_row, first_column, last_column = get_cell_bounds(section, row_idx, col_idx)
 
     merged = first_row != last_row or first_column != last_column
 
@@ -192,20 +173,15 @@ def adjust_row_height(section, row_idx, col_idx, text, font,
                     row = section.writer.wtsheet.row(r)
                     add_row_height(row, height_delta // row_count)
             else:
-                assert adjusted_row_index > row_count, (
-                    adjusted_row_index, row_count
-                )
-                row = section.writer.wtsheet.row(
-                    first_row + adjusted_row_index
-                )
+                assert adjusted_row_index > row_count, (adjusted_row_index, row_count)
+                row = section.writer.wtsheet.row(first_row + adjusted_row_index)
                 add_row_height(row, height_delta)
         else:
             row = section.writer.wtsheet.row(row_idx)
             add_row_height(row, height_delta)
 
 
-def adjust_row_height_arial(section, row_idx, col_idx, text, font_size=10,
-                            adjusted_row_index=None):
+def adjust_row_height_arial(section, row_idx, col_idx, text, font_size=10, adjusted_row_index=None):
     """Устанавливает высоту строки автоматически.
 
     Высота строки устанавливается такая, чтобы текст text
@@ -226,6 +202,4 @@ def adjust_row_height_arial(section, row_idx, col_idx, text, font_size=10,
         ячейки, нумерация начинается с нуля.
     """
     font = get_font(ARIAL, font_size)
-    adjust_row_height(
-        section, row_idx, col_idx, text, font, adjusted_row_index
-    )
+    adjust_row_height(section, row_idx, col_idx, text, font, adjusted_row_index)

educommon/rest/actions.py

@@ -8,7 +8,7 @@ from educommon.rest import (
 
 
 class BaseRestPack(BasePack):
-    """Базовый пак для всех REST пакокв."""
+    """Базовый пак для всех REST паков."""
 
 
 class RestPack(
@@ -17,10 +17,10 @@ class RestPack(
     mixins.CreateModelMixin,
     mixins.UpdateModelMixin,
     mixins.DestroyModelMixin,
-    BaseRestPack
+    BaseRestPack,
 ):
-    """
-    Пак для обработки запросов методами: GET, POST, PUT, PATCH, DELETE.
+    """Пак для обработки запросов методами: GET, POST, PUT, PATCH, DELETE.
+
     Для обработки запросов методом GET исользуются методы пака list и retrieve.
     Для обработки запросов методом POST используется метод пака create.
     Для обработки запросов методом PUT и PATCH используется метод пака update.
@@ -28,12 +28,8 @@ class RestPack(
     """
 
 
-class RestReadOnlyPack(
-    mixins.ListModelMixin,
-    mixins.RetrieveModelMixin,
-    BaseRestPack
-):
-    """
-    Пак который обрабатывает запросы только методом GET.
+class RestReadOnlyPack(mixins.ListModelMixin, mixins.RetrieveModelMixin, BaseRestPack):
+    """Пак который обрабатывает запросы только методом GET.
+
     Доступные методы пака: list и retrieve.
     """

educommon/rest/context.py

@@ -12,14 +12,9 @@ from educommon.rest.misc import (
 )
 
 
-class RestDeclarativeActionContext(
-    ObservableController.VerboseDeclarativeContext
-):
-
+class RestDeclarativeActionContext(ObservableController.VerboseDeclarativeContext):
     def build(self, request, rules):
-        """
-        Выполняет заполнение собственных атрибутов
-        согласно переданному запросу, исходя из списка правил
+        """Выполняет заполнение собственных атрибутов согласно переданному запросу, исходя из списка правил.
 
         :param request:запрос, на основе которого производится
             заполнение контекста
@@ -30,7 +25,7 @@ class RestDeclarativeActionContext(
 
         :raise: TypeError, ContextBuildingError, CriticalContextBuildingError
         """
-        assert self.matches(rules), "rules must be a dict or pair!"
+        assert self.matches(rules), 'rules must be a dict or pair!'
         # определяем режим, если правилла описаны парой
         if isinstance(rules, tuple):
             # режим
@@ -54,10 +49,7 @@ class RestDeclarativeActionContext(
                 try:
                     parser = self._parsers[parser]
                 except KeyError:
-                    raise TypeError(
-                        'Неизвестный парсер контекста: "%s"' %
-                        parser
-                    )
+                    raise TypeError(f'Неизвестный парсер контекста: "{parser}"')
 
             add_error_to = None
             try:
@@ -84,12 +76,10 @@ class RestDeclarativeActionContext(
                 add_error_to = errors
 
             if add_error_to is not None:
-                add_error_to.append(
-                    parser_data.get('verbose_name', key))
+                add_error_to.append(parser_data.get('verbose_name', key))
                 # ошибка критична, если хотя бы один из параметров
                 # не имеет verbose_name
-                only_noncritical = only_noncritical and (
-                    'verbose_name' in parser_data)
+                only_noncritical = only_noncritical and ('verbose_name' in parser_data)
                 continue
 
             setattr(self, key, val)

educommon/rest/controllers.py

@@ -24,9 +24,7 @@ class RestObservableController(ObservableController):
     api = None
     object_id_regex = re.compile(r'/(?P<id>\d+)$')
 
-    class VerboseDeclarativeContext(
-        RestDeclarativeActionContext
-    ):
+    class VerboseDeclarativeContext(RestDeclarativeActionContext):
         def build(self, request, rules):
             self.__declared = list(rules.keys()) + self.__internal_attrs
 
@@ -36,7 +34,7 @@ class RestObservableController(ObservableController):
                 if self.__debug:
                     raise
                 else:
-                    _warn('%r, url="%s"' % (e, request.path_info))
+                    _warn(f'{e!r}, url="{request.path_info}"')
 
             for k, v in list(get_request_params(request).items()):
                 if not hasattr(self, k):
@@ -53,17 +51,18 @@ class RestObservableController(ObservableController):
                     pass
 
     def __init__(self, observer, *args, **kwargs):
-        super(RestObservableController, self).__init__(
-            observer, *args, **kwargs)
+        super().__init__(observer, *args, **kwargs)
+
         self.api = {}
 
     def append_pack(self, pack):
-        super(RestObservableController, self).append_pack(pack)
+        super().append_pack(pack)
+
         self.api[pack.__class__.__name__] = pack.get_absolute_url()
 
     def process_request(self, request):
-        """
-        Обработка входящего запроса *request* от клиента.
+        """Обработка входящего запроса *request* от клиента.
+
         Экшен определяется исходя из метода запроса.
         """
 
@@ -73,4 +72,5 @@ class RestObservableController(ObservableController):
 
         path = self.object_id_regex.sub('', request.path)
         request.path = '{}/{}'.format(path.rstrip('/'), request.method.lower())
-        return super(RestObservableController, self).process_request(request)
+
+        return super().process_request(request)

educommon/rest/mixins.py

@@ -12,48 +12,50 @@ class BaseRestAction(BaseAction):
 
 
 class ListModelMixin:
-    """
-    Примесь для REST паков, обработка запросов метода GET.
+    """Примесь для REST паков, обработка запросов метода GET.
+
     Получения списка объектов.
     """
 
     def __init__(self):
-        super(ListModelMixin, self).__init__()
+        super().__init__()
+
         if not hasattr(self, 'get_action'):
             self.get_action = GetAction()
             self.actions.append(self.get_action)
 
     def list(self, request, context):
-        """
-        Метод отвечает за обработку запроса методом GET.
+        """Метод отвечает за обработку запроса методом GET.
+
         Получение списка объектов.
         """
         raise NotImplementedError
 
 
 class RetrieveModelMixin:
-    """
-    Примесь для REST паков, обработка запросов метода GET.
+    """Примесь для REST паков, обработка запросов метода GET.
+
     Получение конкретно объекта по context.id.
     """
 
     def __init__(self):
-        super(RetrieveModelMixin, self).__init__()
+        super().__init__()
+
         if not hasattr(self, 'get_action'):
             self.get_action = GetAction()
             self.actions.append(self.get_action)
 
     def retrieve(self, request, context):
-        """
-        Метод отвечает за обработку запроса методом GET.
+        """Метод отвечает за обработку запроса методом GET.
+
         Получение конкретного объекта по context.id.
         """
         raise NotImplementedError
 
 
 class GetAction(BaseRestAction):
-    """
-    Экшен обработки запроса методом GET.
+    """Экшен обработки запроса методом GET.
+
     Делегирует обработку методам пака.
     """
 
@@ -71,7 +73,8 @@ class CreateModelMixin:
     """Примесь для REST паков, обработка запросов методом POST."""
 
     def __init__(self):
-        super(CreateModelMixin, self).__init__()
+        super().__init__()
+
         self.post_action = PostAction()
         self.actions.append(self.post_action)
 
@@ -81,8 +84,8 @@ class CreateModelMixin:
 
 
 class PostAction(BaseRestAction):
-    """
-    Экшен обработки запроса методом POST.
+    """Экшен обработки запроса методом POST.
+
     Делегирует обработку методам пака.
     """
 
@@ -97,13 +100,11 @@ class UpdateModelMixin:
     """Примесь для REST паков, обработка запросов методом PUT и PATCH."""
 
     def __init__(self):
-        super(UpdateModelMixin, self).__init__()
+        super().__init__()
+
         self.put_action = PutAction()
         self.patch_action = PatchAction()
-        self.actions.extend([
-            self.put_action,
-            self.patch_action
-        ])
+        self.actions.extend([self.put_action, self.patch_action])
 
     def update(self, request, context):
         """Метод отвечает за изменение объекта."""
@@ -111,8 +112,8 @@ class UpdateModelMixin:
 
 
 class PutAction(BaseRestAction):
-    """
-    Экшен обработки запроса методом PUT.
+    """Экшен обработки запроса методом PUT.
+
     Делегирует обработку методам пака.
     """
 
@@ -124,8 +125,8 @@ class PutAction(BaseRestAction):
 
 
 class PatchAction(BaseRestAction):
-    """
-    Экшен обработки запроса методом PATCH.
+    """Экшен обработки запроса методом PATCH.
+
     Делегирует обработку методам пака.
     """
 
@@ -140,7 +141,8 @@ class DestroyModelMixin:
     """Примесь для REST паков, обработка запросов методом DELETE."""
 
     def __init__(self):
-        super(DestroyModelMixin, self).__init__()
+        super().__init__()
+
         self.delete_action = DeleteAction()
         self.actions.append(self.delete_action)
 
@@ -150,8 +152,8 @@ class DestroyModelMixin:
 
 
 class DeleteAction(BaseRestAction):
-    """
-    Экшен обработки запроса методом PATCH.
+    """Экшен обработки запроса методом PATCH.
+
     Делегирует обработку методам пака.
     """
 

educommon/secure_media/app_meta.py

@@ -22,24 +22,24 @@ from m3_django_compat import (
 
 
 def check_autorization(request, path):
-
     # Если файл в media/public, то отдаем сразу без проверки
     # Вообще это делается соответствующим конфигурированием NGINX
     path_list = path.split(os.path.sep)
-    if path_list and path_list[0] == "public":
+    if path_list and path_list[0] == 'public':
         return sendfile(request, os.path.join(settings.MEDIA_ROOT, path))
 
     if not is_authenticated(request.user):
         result = M3JSONEncoder().encode(
-            {'success': False,
-             'message': 'Вы не авторизованы. Возможно, закончилось время '
-                        'пользовательской сессии. Для повторной '
-                        'аутентификации обновите страницу.'})
+            {
+                'success': False,
+                'message': 'Вы не авторизованы. Возможно, закончилось время '
+                'пользовательской сессии. Для повторной '
+                'аутентификации обновите страницу.',
+            }
+        )
         return http.HttpResponse(result, content_type='application/json')
 
     return sendfile(request, os.path.join(settings.MEDIA_ROOT, path))
 
 
-urlpatterns = [
-    re_path(r'^media/(?P<path>.*)$', check_autorization)
-]
+urlpatterns = [re_path(r'^media/(?P<path>.*)$', check_autorization)]

educommon/utils/__init__.py

@@ -57,11 +57,12 @@ class SingletonMeta(type):
     """
 
     def __init__(cls, name, bases, attrs):
-        super(SingletonMeta, cls).__init__(name, bases, attrs)
+        super().__init__(name, bases, attrs)
+
         cls.instance = None
 
     def __call__(cls, *args, **kwargs):
         if cls.instance is None:
-            cls.instance = super(SingletonMeta, cls).__call__(*args, **kwargs)
+            cls.instance = super().__call__(*args, **kwargs)
 
         return cls.instance

educommon/utils/caching.py

@@ -87,9 +87,7 @@ class CacheWrapper:
         """
         kwarg_vals = tuple(callargs[k] for k in self.names_kwargs)
         hash_kwargs = hash(kwarg_vals)
-        cache_key = '_'.join((
-            self.cache_prefix, self.fn.__name__, str(hash_kwargs)
-        ))
+        cache_key = '_'.join((self.cache_prefix, self.fn.__name__, str(hash_kwargs)))
         return cache_key
 
     def update_cache(self, value, **kw):

educommon/utils/conversion.py

@@ -72,7 +72,5 @@ def float_or_none(value: Union[int, str, None]) -> Optional[float]:
     return result
 
 
-control_chars = ''.join(map(
-    chr, itertools.chain(range(0x00, 0x20), range(0x7f, 0xa0))
-))
+control_chars = ''.join(map(chr, itertools.chain(range(0x00, 0x20), range(0x7F, 0xA0))))
 control_char_re = re.compile(f'[{re.escape(control_chars)}]')

educommon/utils/crypto.py

@@ -36,8 +36,7 @@ class HashData:
 
         if openssl_stderr:
             raise IOError(
-                'Ошибка вычисления значения HASH по алгоритму '
-                f'{self.hash_algorithm}',
+                f'Ошибка вычисления значения HASH по алгоритму {self.hash_algorithm}',
             )
 
         matches = re.compile(self.HASH_PATTERN).search(openssl_stdout.decode())

educommon/utils/date.py

@@ -1,4 +1,5 @@
 """Вспомогательные средства для работы с датами."""
+
 import datetime
 from collections import (
     namedtuple,
@@ -38,7 +39,7 @@ WEEKDAYS = (
     (THU_IDX, 'Четверг'),
     (FRI_IDX, 'Пятница'),
     (SAT_IDX, 'Суббота'),
-    (SUN_IDX, 'Воскресенье')
+    (SUN_IDX, 'Воскресенье'),
 )
 WEEKDAYS_DICT = dict(WEEKDAYS)
 
@@ -59,6 +60,7 @@ def date_range_to_str(date_from, date_to, can_be_one_day_long=False):
     (<2001.01.01>, None,       , True)   -> "01.01.2001"
     (None,         <2002.02.02>, True)   -> "02.02.2002"
     """
+
     def fmt(date):
         return date.strftime('%d.%m.%Y') if date else ''
 
@@ -73,14 +75,14 @@ def date_range_to_str(date_from, date_to, can_be_one_day_long=False):
         if date_from == date_to:
             result = fmt(date_from)
         else:
-            result = 'с %s по %s' % (fmt(date_from), fmt(date_to))
+            result = f'с {fmt(date_from)} по {fmt(date_to)}'
     else:
         if can_be_one_day_long:
             result = fmt(date_from or date_to or None)
         elif date_from:
-            result = 'с %s' % fmt(date_from)
+            result = f'с {fmt(date_from)}'
         elif date_to:
-            result = 'по %s' % fmt(date_to)
+            result = f'по {fmt(date_to)}'
     return result
 
 
@@ -97,9 +99,7 @@ def iter_days_between(date_from, date_to, odd_weeks_only=False):
     if date_from > date_to:
         raise ValueError('date_from must be lower or equal date_to!')
 
-    for dt in rrule.rrule(
-        rrule.DAILY, dtstart=date_from, until=date_to
-    ):
+    for dt in rrule.rrule(rrule.DAILY, dtstart=date_from, until=date_to):
         if odd_weeks_only and dt.isocalendar()[1] % 2 != 0:
             # если требуются четные недели относительно начала года
             continue
@@ -154,11 +154,7 @@ def get_week_dates(date=None):
 
     monday = get_week_start(date)
 
-    return (
-        day.date()
-        for day in rrule.rrule(rrule.DAILY, dtstart=monday,
-                               count=len(WEEKDAYS))
-    )
+    return (day.date() for day in rrule.rrule(rrule.DAILY, dtstart=monday, count=len(WEEKDAYS)))
 
 
 def get_weekdays_for_date(date=None, weekday_names=None):
@@ -176,10 +172,7 @@ def get_weekdays_for_date(date=None, weekday_names=None):
     """
     weekday_names = weekday_names or WEEKDAYS_DICT
 
-    return tuple(
-        (weekday_names[day.weekday()], day)
-        for day in get_week_dates(date)
-    )
+    return tuple((weekday_names[day.weekday()], day) for day in get_week_dates(date))
 
 
 def get_today_min_datetime() -> datetime:
@@ -193,7 +186,7 @@ def get_today_max_datetime() -> datetime:
 
 
 def get_date_range_intersection(
-    *date_ranges: Tuple[datetime.date, datetime.date]
+    *date_ranges: Tuple[datetime.date, datetime.date],
 ) -> Union[Tuple[datetime.date, datetime.date], tuple]:
     """Возвращает минимальный внутренний диапазон дат из переданных диапазонов дат.
 
@@ -210,19 +203,14 @@ def get_date_range_intersection(
     return date_range
 
 
-def is_date_range_intersection(
-    *date_ranges: Tuple[datetime.date, datetime.date]
-) -> bool:
+def is_date_range_intersection(*date_ranges: Tuple[datetime.date, datetime.date]) -> bool:
     """Возвращает признак того, что диапазоны дат пересекаются."""
     intersection = get_date_range_intersection(*date_ranges)
 
     return True if intersection else False
 
 
-def date_to_str(
-    date_: Optional[Union[datetime.date, datetime.datetime]],
-    fmt: str = settings.DATE_FORMAT
-) -> str:
+def date_to_str(date_: Optional[Union[datetime.date, datetime.datetime]], fmt: str = settings.DATE_FORMAT) -> str:
     """Конвертирует дату в строку или возвращает '' если даты нет."""
     return date_.strftime(fmt) if date_ else ''
 
@@ -244,8 +232,7 @@ class Week(namedtuple('Week', ('year', 'week'))):
         неделя года.
         """
         d = datetime.date(self.year, 1, 4)
-        return d + datetime.timedelta(
-            weeks=self.week - 1, days=-d.weekday() + number)
+        return d + datetime.timedelta(weeks=self.week - 1, days=-d.weekday() + number)
 
     def monday(self) -> datetime.date:
         """Дата понедельника."""