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

educommon/utils/db/__init__.py

@@ -74,10 +74,10 @@ def get_related_fields(model, skip_func=None):
         if not related_model._meta.proxy:
             for field in related_model._meta.get_fields():
                 if (
-                    field.concrete and
-                    isinstance(field, RelatedField) and
-                    issubclass(model, get_related(field).parent_model) and
-                    (not skip_func or not skip_func(field))
+                    field.concrete
+                    and isinstance(field, RelatedField)
+                    and issubclass(model, get_related(field).parent_model)
+                    and (not skip_func or not skip_func(field))
                 ):
                     yield field
 
@@ -134,10 +134,7 @@ def get_related_instances(obj, collapse=True, skip_func=None):
     """
 
     assert isinstance(obj, Model), type(obj)
-    for model, fields in groupby(
-        get_related_fields(obj.__class__, skip_func),
-        lambda field: field.model
-    ):
+    for model, fields in groupby(get_related_fields(obj.__class__, skip_func), lambda field: field.model):
         conditions = reduce(or_, (Q(**{field.name: obj}) for field in fields))
         for related_obj in model.objects.filter(conditions).iterator():
             if collapse:
@@ -145,13 +142,10 @@ def get_related_instances(obj, collapse=True, skip_func=None):
             else:
                 for field in model._meta.get_fields():
                     if (
-                        field.concrete and
-                        isinstance(field, RelatedField) and
-                        (
-                            field.related_model == obj.__class__ and
-                            getattr(related_obj, field.attname) == obj.pk
-                        ) and
-                        (not skip_func or not skip_func(field))
+                        field.concrete
+                        and isinstance(field, RelatedField)
+                        and (field.related_model == obj.__class__ and getattr(related_obj, field.attname) == obj.pk)
+                        and (not skip_func or not skip_func(field))
                     ):
                         yield related_obj
 
@@ -188,21 +182,18 @@ def get_non_block_relations(obj):
     """
 
     displayed_relations = dict()
-    collector = Collector(
-        using=router.db_for_write(obj.__class__, instance=obj)
-    )
+    collector = Collector(using=router.db_for_write(obj.__class__, instance=obj))
     collector.collect((obj,))
     # Коллектор содержит ссылку на obj, удалим сам объект из коллектора
     collector.data[obj.__class__].remove(obj)
 
     for model, related_objects in collector.data.items():
-        if all((
-            getattr(model, 'display_related_error', True),
-            related_objects
-        )):
-            key = '.'.join((
-                model._meta.app_label,
-                model._meta.object_name,
-            ))
+        if all((getattr(model, 'display_related_error', True), related_objects)):
+            key = '.'.join(
+                (
+                    model._meta.app_label,
+                    model._meta.object_name,
+                )
+            )
             displayed_relations[key] = tuple(related_objects)
     return displayed_relations

educommon/utils/db/postgresql.py

@@ -19,10 +19,7 @@ def is_extension_exists(alias, name):
     :rtype: bool
     """
     with closing(connections[alias].cursor()) as cursor:
-        cursor.execute(
-            "SELECT 1 FROM pg_extension WHERE extname = %s",
-            (name,)
-        )
+        cursor.execute('SELECT 1 FROM pg_extension WHERE extname = %s', (name,))
         return cursor.fetchone() is not None
 
 

educommon/utils/fonts/__init__.py

@@ -1,4 +1,5 @@
 """Средства для работы со шрифтами."""
+
 import os.path
 
 from PIL import (
@@ -51,6 +52,7 @@ def _split_word(font, word, max_width):
 
     :rtype: tuple: (<Часть слова, умещающаяся в max_width>, <остаток>).
     """
+
     def _split_index(index, max_index=None):
         """Рекурсивно разбивает слово на две части.
 
@@ -59,14 +61,12 @@ def _split_word(font, word, max_width):
                               больше максимальной.
         """
         index = int(index)
-        assert index > 0, ('Ширины строки не хватает, '
-                           'чтобы поместить один символ')
+        assert index > 0, 'Ширины строки не хватает, чтобы поместить один символ'
 
         # определяем ширину слова в пикселях
         width, _ = font.getsize(word[:index])
 
         if width > max_width:
-
             if index == max_index:
                 # Если индексы равны, значит предыдущее условие было
                 # width < max_width, а предыдущий index на единицу меньше.
@@ -77,7 +77,6 @@ def _split_word(font, word, max_width):
             return _split_index(index // 2, index)
 
         elif width < max_width:
-
             if max_index is None:
                 # Нас обманули, слово влазит в одну строку.
                 return index

educommon/utils/licence/__init__.py

@@ -23,8 +23,7 @@ class LicenceError(Exception):
 class Licence:
     """Базовый класс лицензии."""
 
-    def __init__(self, licence_file_path, schema_file_path, config,
-                 params_root='//BarsLicence/LicenceData'):
+    def __init__(self, licence_file_path, schema_file_path, config, params_root='//BarsLicence/LicenceData'):
         """Инициализация экземпляра класса.
 
         :param basestring licence_file_path: Путь к файлу лицензии.
@@ -67,14 +66,10 @@ class Licence:
             существует, либо к нему нет доступа.
         """
         if not os.path.exists(file_path):
-            raise ImproperlyConfigured(
-                'Licence file not found: ' + file_path
-            )
+            raise ImproperlyConfigured(f'Licence file not found: {file_path}')
 
         if not os.access(file_path, os.R_OK):
-            raise ImproperlyConfigured(
-                "Can't read licence file: " + file_path
-            )
+            raise ImproperlyConfigured(f"Can't read licence file: {file_path}")
 
     @cached_property
     def _params_elements(self):
@@ -97,14 +92,10 @@ class Licence:
                 schema_uri=schema_uri,
             )
         except etree.XMLSyntaxError as error:
-            raise LicenceError(
-                'Error parsing licence XML document {}:\n{}'
-                .format(self.licence_file_path, str(error))
-            )
+            raise LicenceError('Error parsing licence XML document {}:\n{}'.format(self.licence_file_path, str(error)))
 
         result = document_tree.xpath(self._params_root)[0]
 
-
         # поскольку промежуточный результат в памяти хранить необязательно,
         # а необходим он только в 2 местах, кладем его в список 2 раза, после
         # этого достаем в каждом и не храним в памяти промежуточные результаты
@@ -131,9 +122,7 @@ class Licence:
         """
         params_root_element = self._params_elements.pop()
 
-        return set(
-            params_root_element.xpath('plugins/plugin/attribute::name')
-        )
+        return set(params_root_element.xpath('plugins/plugin/attribute::name'))
 
     def __getattr__(self, attr_name):
         return self._params[attr_name]

educommon/utils/misc.py

@@ -19,7 +19,7 @@ class cached_property(property):
     """
 
     def __init__(self, method):
-        super(cached_property, self).__init__(method)
+        super().__init__(method)
 
         self.__doc__ = method.__doc__
 
@@ -66,11 +66,7 @@ def get_nested_attr(obj, attr, default=Undefined):
             if default is not Undefined:
                 return default
             else:
-                raise AttributeError(
-                    "'{}' object has no attribute '{}'".format(
-                        type(obj), nested_attribute
-                    )
-                )
+                raise AttributeError("'{}' object has no attribute '{}'".format(type(obj), nested_attribute))
 
     return nested_object
 
@@ -78,7 +74,7 @@ def get_nested_attr(obj, attr, default=Undefined):
 def md5sum(filepath):
     """Возвращает контрольную сумму MD5 указанного файла.
 
-    :param basestring filepath: Путь к файлу.
+    :param str filepath: Путь к файлу.
 
     :rtype: str
     """
@@ -113,9 +109,10 @@ def get_mime_type_for_extension(extension):
     :rtype: str
     """
     import mimetypes
+
     mimetypes.init()
     if not extension.startswith('.'):
-        extension = '.%s' % extension
+        extension = f'.{extension}'
     return mimetypes.types_map.get(extension.lower())
 
 
@@ -131,19 +128,13 @@ def message_to_sentry(message=None, extra=None, tag=None, level=logging.INFO):
             from sentry_sdk import (
                 capture_message,
             )
-            capture_message(
-                message=message,
-                level=level,
-                extras=extra,
-                tags={'tags': tag} if tag else None
-            )
+
+            capture_message(message=message, level=level, extras=extra, tags={'tags': tag} if tag else None)
         else:
             from raven.contrib.django.raven_compat.models import (
                 client as sentry_client,
             )
+
             sentry_client.captureMessage(
-                message=message,
-                data={'level': level},
-                extra=extra,
-                tags={'tags': tag} if tag else None
+                message=message, data={'level': level}, extra=extra, tags={'tags': tag} if tag else None
             )

educommon/utils/object_grid.py

@@ -1,4 +1,5 @@
 """Утилиты для ObjectGrid."""
+
 import json
 
 from m3.actions.urls import (
@@ -31,18 +32,14 @@ def add_action_button(label, grid, action, icon_cls, index=None):
         add_action_button('Печать', grid, self.print_action, Icons.PRINTER)
     """
     action_url = get_url(action)
-    button = ext.ExtButton(
-        text=label,
-        handler=_get_action_handler(action_url),
-        icon_cls=icon_cls)
+    button = ext.ExtButton(text=label, handler=_get_action_handler(action_url), icon_cls=icon_cls)
     if index is not None:
         grid.top_bar.items.insert(index, button)
     else:
         grid.top_bar.items.append(button)
 
 
-def add_one_row_button(label, grid, action, icon_cls,
-                       dbl_clicked=False, index=None):
+def add_one_row_button(label, grid, action, icon_cls, dbl_clicked=False, index=None):
     """
     Добавление кнопки в тулбар и popup меню ObjectGrid'а.
 
@@ -81,8 +78,7 @@ def add_one_row_button(label, grid, action, icon_cls,
         grid.handler_dblclick = grid.dblclick_handler
 
 
-def add_multi_row_button(label, grid, action, icon_cls,
-                         confirm_required=False, index=None):
+def add_multi_row_button(label, grid, action, icon_cls, confirm_required=False, index=None):
     """
     Добавление кнопки в тулбар и popup меню ObjectGrid'а.
 
@@ -137,27 +133,27 @@ def _get_multirow_params(label, action, icon_cls, confirm_required):
 
 
 def _get_action_handler(url):
-    return """
-        function(){
-            onObjGridAction(objGrid, '%s');
-        }
-    """ % url
+    return f"""
+        function() {{
+            onObjGridAction(objGrid, '{url}');
+        }}
+    """
 
 
 def _get_one_row_handler(action_name, url):
-    return """
-        function(){
-            onObjGridOneRecordAction(objGrid, '%s', '%s');
-        }
-    """ % (action_name, url)
+    return f"""
+        function() {{
+            onObjGridOneRecordAction(objGrid, '{action_name}', '{url}');
+        }}
+    """
 
 
 def _get_multi_row_handler(action_name, url, confirm_required):
-    return """
-        function(){
-            onObjGridMultiRecordAction(objGrid, '%s', '%s', %s);
-        }
-    """ % (action_name, url, int(bool(confirm_required)))
+    return f"""
+        function() {{
+            onObjGridMultiRecordAction(objGrid, '{action_name}', '{url}', {int(bool(confirm_required))});
+        }}
+    """
 
 
 def column_style_renderer(styles_map, default_style=''):
@@ -166,13 +162,15 @@ def column_style_renderer(styles_map, default_style=''):
     :param styles_map: словарь карты стилей по значению в колонке
     :param default_style: стиль по-умолчанию
     """
-    func = (
-        """function (value, metaData, record, rowIndex, colIndex, store) {
-            var styles_map = Ext.util.JSON.decode('%(styles_map)s');
-            metaData.style += styles_map[value] || '%(default_style)s';
-            return value;
-        }""") % {'styles_map': styles_map, 'default_style': default_style}
-    return func
+    styles_map = json.dumps(styles_map)
+
+    return f"""
+    function (value, metaData, record, rowIndex, colIndex, store) {{
+        var styles_map = Ext.util.JSON.decode('{styles_map}');
+        metaData.style += styles_map[value] || '{default_style}';
+        return value;
+    }}
+    """
 
 
 def set_grid_initial(grid, initializers):
@@ -194,12 +192,12 @@ def set_grid_initial(grid, initializers):
         ))
     """
     grid_initializers = ''.join(initializers)
-    grid._listeners['added'] = """
-        function() {
-            var grid = Ext.getCmp('%(client_id)s');
-            %(initializers)s
-        }
-    """ % {'initializers': grid_initializers, 'client_id': grid.client_id}
+    grid._listeners['added'] = f"""
+        function() {{
+            var grid = Ext.getCmp('{grid.client_id}');
+            {grid_initializers}
+        }}
+    """
 
 
 def styling_grid_rows(data_index, styles_map, default_style=''):
@@ -209,18 +207,16 @@ def styling_grid_rows(data_index, styles_map, default_style=''):
     :param styles_map: словарь карты стилей по значению в колонке
     :param default_style: стиль по-умолчанию
     """
-    return """
-        var styles_map = Ext.util.JSON.decode('%(styles_map)s');
-        grid.getView().getRowClass = function(record, rowIndex, rp, ds){
+    styles_map = json.dumps(styles_map)
+
+    return f"""
+        var styles_map = Ext.util.JSON.decode('{styles_map}');
+        grid.getView().getRowClass = function(record, rowIndex, rp, ds) {{
             return styles_map[
-                record.json.%(data_index)s
-            ] || '%(default_style)s';
-        };
-    """ % {
-        'data_index': data_index,
-        'styles_map': json.dumps(styles_map),
-        'default_style': default_style,
-    }
+                record.json.{data_index}
+            ] || '{default_style}';
+        }};
+    """
 
 
 def add_tooltip_to_grid_rows(delegate: str, column_with_text: str) -> str:
@@ -229,26 +225,23 @@ def add_tooltip_to_grid_rows(delegate: str, column_with_text: str) -> str:
     :param delegate: css-класс строк к которым добавляется подсказка
     :param column_with_text: наименование колонки содержащей текст подсказки
     """
-    return """
+    return f"""
         var view = grid.getView();
         var store = grid.getStore();
-        grid.on('render', function(grid) {
-            grid.tooltip = new Ext.ToolTip({
+        grid.on('render', function(grid) {{
+            grid.tooltip = new Ext.ToolTip({{
                 target: view.mainBody,
-                delegate: '%(delegate)s',
-                listeners: {
-                    show: function updateTipBody(tooltip) {
+                delegate: '{delegate}',
+                listeners: {{
+                    show: function updateTipBody(tooltip) {{
                         var rowIndex = view.findRowIndex(tooltip.triggerElement);
-                        var text = store.getAt(rowIndex).data['%(column)s'];
+                        var text = store.getAt(rowIndex).data['{column_with_text}'];
                         tooltip.update(text);
-                    }
-                }
-            });
-        });
-    """ % {
-        'delegate': delegate,
-        'column': column_with_text,
-    }
+                    }}
+                }}
+            }});
+        }});
+    """
 
 
 def boolean_column_renderer():

educommon/utils/phone_number/modelfields.py

@@ -69,9 +69,7 @@ class PhoneField(CharField):
         kwargs.setdefault('max_length', 31)
         super().__init__(*args, **kwargs)
 
-        self.validators.append(
-            PHONE_FIELD_TYPE_TO_VALIDATOR.get(phone_type, validate_common_phone_number)
-        )
+        self.validators.append(PHONE_FIELD_TYPE_TO_VALIDATOR.get(phone_type, validate_common_phone_number))
 
     def to_python(self, value):
         """Преобразование входящего значения в ожидаемый тип Python."""

educommon/utils/phone_number/phone_number.py

@@ -11,12 +11,12 @@ from educommon.utils.phone_number.enums import (
 
 
 PHONE_REGEX = re.compile(
-    r'^(?:'                                             # группа с кодом страны и кодом региона
-    r'(\+[1-6,90]{1,3}|\+?7|\+?8)?-?\s*'                # опциональный код страны (+XXX, для России может быть +7, 7, 8)
+    r'^(?:'  # группа с кодом страны и кодом региона
+    r'(\+[1-6,90]{1,3}|\+?7|\+?8)?-?\s*'  # опциональный код страны (+XXX, для России может быть +7, 7, 8)
     r'\(?(\d{3}(?:[-\s]?\d{0,2}(?=[)-.\s]))?)\)?[-.\s]*'  # оцпиональный код региона/города в необязательных скобках
-    r')?'                                                 # группа с кодом страны и кодом региона может отсутствовать
+    r')?'  # группа с кодом страны и кодом региона может отсутствовать
     r'(\d{1,2}[-.\s]*\d?)[-.\s]*(\d[-.\s]*\d)[-.\s]*(\d[-.\s]*\d)$'  # абонентский номер в формате XXX-XX-XX
-                                                                     # первая группа может состоять от 1 до 3 цифр
+    # первая группа может состоять от 1 до 3 цифр
 )
 
 # российский мобильный номер вида +7 (9XX) XXX-XX-XX
@@ -177,10 +177,7 @@ class PhoneNumber:
     @property
     def is_russia(self) -> bool:
         """Признак, что номер российский."""
-        return (
-            self._cleaned.startswith(RU_PHONE_CODE)
-            or (self.is_valid and not self.region_code)
-        )
+        return self._cleaned.startswith(RU_PHONE_CODE) or (self.is_valid and not self.region_code)
 
     @property
     def cleaned(self) -> str:

educommon/utils/phone_number/validators.py

@@ -18,8 +18,7 @@ def validate_common_phone_number(phone_number: Union[str, PhoneNumber]):
 
     if isinstance(phone_number, PhoneNumber) and not phone_number.is_valid:
         raise ValidationError(
-            'Неверный формат! Примеры допустимых форматов: '
-            '+XXX (XXX) XXX XX XX, 8 (XXXXX) X-XX-XX, XXX-XX-XX',
+            'Неверный формат! Примеры допустимых форматов: +XXX (XXX) XXX XX XX, 8 (XXXXX) X-XX-XX, XXX-XX-XX',
             code='invalid',
         )
 
@@ -28,14 +27,9 @@ def validate_e164_phone_number(phone_number: Union[str, PhoneNumber]):
     """Валидация номера телефона в международном формате."""
     phone_number = to_python(phone_number)
 
-    if (
-        isinstance(phone_number, PhoneNumber)
-        and not phone_number.is_valid
-        or not phone_number.is_e164
-    ):
+    if isinstance(phone_number, PhoneNumber) and not phone_number.is_valid or not phone_number.is_e164:
         raise ValidationError(
-            'Неверный формат! Примеры допустимых форматов: '
-            '+XXX (XXX) XXX XX XX, +7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX',
+            'Неверный формат! Примеры допустимых форматов: +XXX (XXX) XXX XX XX, +7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX',
             code='invalid',
         )
 
@@ -44,14 +38,9 @@ def validate_ru_phone_number(phone_number: Union[str, PhoneNumber]):
     """Валидация российского номера телефона в общем формате."""
     phone_number = to_python(phone_number)
 
-    if (
-        isinstance(phone_number, PhoneNumber)
-        and not phone_number.is_valid
-        or not phone_number.is_russia
-    ):
+    if isinstance(phone_number, PhoneNumber) and not phone_number.is_valid or not phone_number.is_russia:
         raise ValidationError(
-            'Неверный формат! Примеры допустимых форматов: '
-            '+7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX, XXX-XX-XX',
+            'Неверный формат! Примеры допустимых форматов: +7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX, XXX-XX-XX',
             code='invalid',
         )
 
@@ -66,8 +55,7 @@ def validate_ru_e164_phone_number(phone_number: Union[str, PhoneNumber]):
         or not (phone_number.is_russia and phone_number.is_e164)
     ):
         raise ValidationError(
-            'Неверный формат! Примеры допустимых форматов: '
-            '+7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX, (XXX) XXX-XX-XX',
+            'Неверный формат! Примеры допустимых форматов: +7 (XXX) XXX-XX-XX, 8 (XXXXX) X-XX-XX, (XXX) XXX-XX-XX',
             code='invalid',
         )
 
@@ -80,13 +68,10 @@ def validate_ru_mobile_phone_number(phone_number: Union[str, PhoneNumber]):
         isinstance(phone_number, PhoneNumber)
         and not phone_number.is_valid
         or not (
-            phone_number.region_code
-            and len(phone_number.region_code) == 3
-            and phone_number.region_code.startswith('9')
+            phone_number.region_code and len(phone_number.region_code) == 3 and phone_number.region_code.startswith('9')
         )
     ):
         raise ValidationError(
-            'Неверный формат! Примеры допустимых форматов: '
-            '+7 (9XX) XXX-XX-XX, 7 (9XX) XXX XX XX, 89XXXXXXXXX',
+            'Неверный формат! Примеры допустимых форматов: +7 (9XX) XXX-XX-XX, 7 (9XX) XXX XX XX, 89XXXXXXXXX',
             code='invalid',
         )

educommon/utils/plugins.py

@@ -29,7 +29,6 @@ __all__ = ['extender_for']
 
 
 class _ExtenderRegistry(metaclass=SingletonMeta):
-
     """Реестр расширителей классов.
 
     Обеспечивает работу декораторов
@@ -90,13 +89,7 @@ def _function_types():
         WrapperDescriptorType,
     )
 
-    return (
-        FunctionType,
-        MethodType,
-        WrapperDescriptorType,
-        MethodWrapperType,
-        MethodDescriptorType
-    )
+    return (FunctionType, MethodType, WrapperDescriptorType, MethodWrapperType, MethodDescriptorType)
 
 
 _function_types = lru_cache(maxsize=1)(_function_types)
@@ -172,10 +165,8 @@ def _extendable(func):
        :caption: Пример использования
 
        class EditWindow(BaseEditWindow):
-
            @extendable
-           def set_params(self, params):
-               ...
+           def set_params(self, params): ...
     """
     assert isinstance(func, _function_types()), func
 
@@ -184,12 +175,13 @@ def _extendable(func):
         from m3_django_compat import (
             WrapperDescriptorType,
         )
-        unbound_types = (FunctionType, WrapperDescriptorType,)
 
-        assert all((
-            isinstance(func, unbound_types),
-            not isclass(self))
-        ), 'Нельзя расширить staticmethod и classmethod'
+        unbound_types = (
+            FunctionType,
+            WrapperDescriptorType,
+        )
+
+        assert all((isinstance(func, unbound_types), not isclass(self))), 'Нельзя расширить staticmethod и classmethod'
 
         result = func(self, *args, **kwargs)
 
@@ -222,9 +214,9 @@ def get_plugin_apps():
         app_config
         for app_config in apps.get_app_configs()
         if (
-            hasattr(app_config.module, 'plugin_meta') and
-            hasattr(app_config.module.plugin_meta, 'connect_plugin') and
-            callable(app_config.module.plugin_meta.connect_plugin)
+            hasattr(app_config.module, 'plugin_meta')
+            and hasattr(app_config.module.plugin_meta, 'connect_plugin')
+            and callable(app_config.module.plugin_meta.connect_plugin)
         )
     )
 
@@ -250,20 +242,15 @@ def init_plugin(package, settings=None, config=None):
             {},  # globals
             {},  # locals
             ['connect_plugin'],  # from list
-            0  # absolute import
+            0,  # absolute import
         )
     except ImportError:
-        raise ImproperlyConfigured(
-            '{} is not plugin application.'.format(package)
-        )
+        raise ImproperlyConfigured('{} is not plugin application.'.format(package))
 
     meta_module.__package__ = package
 
-    if (not hasattr(meta_module, 'connect_plugin') or
-            not callable(meta_module.connect_plugin)):
+    if not hasattr(meta_module, 'connect_plugin') or not callable(meta_module.connect_plugin):
         raise ImproperlyConfigured(
-            '{} is not a plugin application '
-            '(module {} has not connect_plugin function)'
-            .format(package, meta_module)
+            '{} is not a plugin application (module {} has not connect_plugin function)'.format(package, meta_module)
         )
     meta_module.connect_plugin(settings, config or {})

educommon/utils/registry.py

@@ -10,7 +10,8 @@ class ModelHandlerRegistry:
         assert isinstance(handlers, dict)
         assert all(map(callable, handlers.values()))
 
-        super(ModelHandlerRegistry, self).__init__()
+        super().__init__()
+
         self._handlers = handlers
 
     def get_model_handler(self, model):

educommon/utils/seqtools.py

@@ -17,7 +17,5 @@ def make_chunks(
 
     for first in iterator:
         yield (
-            list(chain([first], islice(iterator, size - 1)))
-            if is_list
-            else chain([first], islice(iterator, size - 1))
+            list(chain([first], islice(iterator, size - 1))) if is_list else chain([first], islice(iterator, size - 1))
         )