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

educommon/report/constructor/builders/excel/_header.py

@@ -31,11 +31,7 @@ class HierarchicalHeaderMixin:
         def get_row_count(root_descriptors):
             # Возвращает количество строк, занимаемое заголовком.
             return max(
-                (
-                    1 + get_row_count(descriptor.children)
-                    if descriptor.children
-                    else 1
-                )
+                (1 + get_row_count(descriptor.children) if descriptor.children else 1)
                 for descriptor in root_descriptors
             )
 
@@ -67,10 +63,7 @@ class HierarchicalHeaderMixin:
 
         def set_column_count(descriptor):
             if descriptor.children:
-                descriptor.width = sum(
-                    set_column_count(child)
-                    for child in descriptor.children
-                )
+                descriptor.width = sum(set_column_count(child) for child in descriptor.children)
             else:
                 descriptor.width = 1
 

educommon/report/constructor/builders/excel/product.py

@@ -24,8 +24,10 @@ from educommon.utils.misc import (
 
 
 class _Cell:
-    # Класс для хранения значения ячейки отчета и порядкового номера ячейки.
-    # Позволяет сортировать ячейки в соответстии с их порядковым номером.
+    """Класс для хранения значения ячейки отчета и порядкового номера ячейки.
+
+    Позволяет сортировать ячейки в соответстии с их порядковым номером.
+    """
 
     def __init__(self, index, value):
         self.index = index
@@ -39,23 +41,15 @@ def _join(simple_data, block_indexes, block_row_data):
     """Объединяет данные основной записи и данные строки блока"""
 
     # Проставление порядковых номеров
-    block_row_data = tuple(
-        _Cell(index, data)
-        for index, data in zip(block_indexes, block_row_data)
-    )
+    block_row_data = tuple(_Cell(index, data) for index, data in zip(block_indexes, block_row_data))
 
     # Объединение данных блока и данных записи + упорядочивание.
     block_row_data = sorted(simple_data + block_row_data)
 
     # Преобразование данных в "плоский" кортеж (удаление вложенных кортежей).
-    return tuple(chain(*(
-        (
-            cell.value
-            if isinstance(cell.value, (tuple, list))
-            else (cell.value,)
-        )
-        for cell in block_row_data
-    )))
+    return tuple(
+        chain(*((cell.value if isinstance(cell.value, (tuple, list)) else (cell.value,)) for cell in block_row_data))
+    )
 
 
 class ReportBuilder(HierarchicalHeaderMixin, ReportBuilderBase):
@@ -92,19 +86,13 @@ class ReportBuilder(HierarchicalHeaderMixin, ReportBuilderBase):
               записи. Результат возвращается в виде блока записей.
         """
         if is_block(data):
-            return tuple(chain(*(
-                ReportBuilder._data_to_rows(row)
-                for row in data
-            )))
+            return tuple(chain(*(ReportBuilder._data_to_rows(row) for row in data)))
 
         else:
             # Все вложенные блоки записи нужно преобразовать к плоской
             # структуре, чтобы они содержали только данные (без вложенных
             # блоков). Т.е. в итоге не должно быть многоуровневой вложенности.
-            data = tuple(
-                ReportBuilder._data_to_rows(cell) if is_block(cell) else cell
-                for cell in data
-            )
+            data = tuple(ReportBuilder._data_to_rows(cell) if is_block(cell) else cell for cell in data)
 
             # После того, как избавились от вложенных блоков, нужно вычислить
             # декартово произведение данной записи и вложенных в неё блоков.
@@ -117,15 +105,8 @@ class ReportBuilder(HierarchicalHeaderMixin, ReportBuilderBase):
                 store = block_indexes if is_block(cell) else simple_indexes
                 store.append(index)
 
-            simple_data = tuple(
-                _Cell(index, data[index])
-                for index in simple_indexes
-            )
-            blocks_data = product(*(
-                cell_data
-                for cell_data in data
-                if is_block(cell_data)
-            ))
+            simple_data = tuple(_Cell(index, data[index]) for index in simple_indexes)
+            blocks_data = product(*(cell_data for cell_data in data if is_block(cell_data)))
 
             join = partial(_join, simple_data, block_indexes)
             return tuple(map(join, blocks_data))
@@ -140,6 +121,4 @@ class ReportBuilder(HierarchicalHeaderMixin, ReportBuilderBase):
                 else:
                     style = self._data_cell_style
 
-                self._worksheet.write(
-                    row_number, column_number, cell_data, style
-                )
+                self._worksheet.write(row_number, column_number, cell_data, style)

educommon/report/constructor/builders/excel/with_merged_cells.py

@@ -1,4 +1,5 @@
-"""Реализация построителя отчетов ."""
+"""Реализация построителя отчетов."""
+
 from datetime import (
     date,
     datetime,
@@ -17,7 +18,6 @@ from educommon.utils.misc import (
 
 
 class Frame:
-
     def __init__(self, worksheet, top, left, style):
         self._worksheet = worksheet
         self._top = top
@@ -32,13 +32,16 @@ class Frame:
 
     @property
     def written_rows(self):
+        """Количество строк, записанных в текущей области."""
         return self._written_rows
 
     @property
     def written_columns(self):
+        """Количество колонок, записанных в текущей области."""
         return self._written_columns
 
     def _nested_frame(self):
+        """Создаёт вложенную область отчёта относительно текущей позиции."""
         return Frame(
             worksheet=self._worksheet,
             top=self._top + self._current_row,
@@ -47,10 +50,12 @@ class Frame:
         )
 
     def new_row(self):
+        """Переходит к следующей строке отчёта."""
         self._current_row = self._top + self._written_rows
         self._current_column = self._left
 
     def _write_cell(self, cell_data, height):
+        """Записывает одну ячейку с возможным объединением по вертикали."""
         assert height > 0, height
 
         if isinstance(cell_data, (date, time, datetime)):
@@ -61,18 +66,20 @@ class Frame:
         top = self._top + self._current_row
         left = self._left + self._current_column
         if height > 1:
-            self._worksheet.merge_range(
-                top, left, top + height - 1, left, cell_data, style
-            )
+            self._worksheet.merge_range(top, left, top + height - 1, left, cell_data, style)
         else:
             self._worksheet.write(
-                top, left, cell_data, style,
+                top,
+                left,
+                cell_data,
+                style,
             )
         self._written_rows = max(height, self._written_rows)
         self._current_column += 1
         self._written_columns += 1
 
     def _write_block(self, data, row_height=None):
+        """Записывает блок строк (вложенных списков) в область отчёта."""
         block_rows = block_columns = 0
 
         for row_data in data:
@@ -106,25 +113,21 @@ class Frame:
 
     @staticmethod
     def _get_row_height(record_data):
+        """Определяет высоту строки с учётом вложенных данных."""
         # Возвращает количество строк, занимаемое записью (с учетом вложенных
         # блоков).
 
         def get_row_height(cell_data):
             # Возвращает количество строк, которое необходимо
             if isinstance(cell_data, list):
-                return max(1, sum(
-                    get_row_height(data)
-                    for data in cell_data
-                    if isinstance(data, list)
-                ))
+                return max(1, sum(get_row_height(data) for data in cell_data if isinstance(data, list)))
             else:
                 return 1
 
-        return max(
-            map(get_row_height, record_data)
-        )
+        return max(map(get_row_height, record_data))
 
     def _write_row(self, data):
+        """Записывает одну логическую строку, содержащую ячейки и/или вложенные блоки."""
         row_height = self._get_row_height(data)
 
         for cell_data in data:
@@ -134,6 +137,7 @@ class Frame:
                 self._write_cell(cell_data, row_height)
 
     def write(self, data):
+        """Записывает данные в область отчёта: строку, блок или одну ячейку."""
         if all(isinstance(d, list) for d in data):
             self._write_block(data)
         elif isinstance(data, list):

educommon/report/constructor/config.py

@@ -1,4 +1,5 @@
 """Конфигурация асинхронной сборки отчета."""
+
 from abc import (
     ABCMeta,
     abstractmethod,
@@ -15,6 +16,7 @@ class ConstructorConfig(metaclass=ABCMeta):
 
         :rtype: :class:`celery.app.task.Task`
         """
+
     @property
     @abstractmethod
     def current_user_func(self):