feat: возможность для пользователя передавать тип загружаемого файла как строку by someqst · Pull Request #119 · love-apples/maxapi

someqst · 2026-04-18T21:23:08Z

Столкнулся с проблемой, что тип загружаемого файла нельзя передать строкой.
Думаю, стоит позволить пользователю передавать строку.

Также сделал небольшой рефакторинг функционала определения типа файла на основе содержимого во избежание дублирования кода.

Copilot

Pull request overview

PR добавляет возможность передавать тип загружаемого файла как строку (в дополнение к UploadType) и выносит определение типа по содержимому в общий хелпер, чтобы убрать дублирование.

Changes:

Расширен API InputMedia для приема type как UploadType | str.
Вынесена логика определения типа файла по содержимому в функцию detect_file_type.
Унифицирована валидация type с выдачей понятной ошибки при неверном значении.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-19T17:49:30Z

+    Определяет тип файла на основе его содержимого (MIME-типа).
+
+    Args:
+        data (bytes): Буфер с содержимым файла.


В detect_file_type докстринг описывает аргументы, но не документирует возвращаемое значение (и возможные исключения). В этом репозитории обычно указываются секции Returns: (и часто Raises:) — стоит добавить их, чтобы поведение функции было однозначно описано.

Suggested change

data (bytes): Буфер с содержимым файла.

data (bytes): Буфер с содержимым файла.

Returns:

UploadType: Определенный тип файла. Если MIME-тип не удалось

определить или при определении произошла ошибка, возвращается

``UploadType.FILE``.

Copilot · 2026-04-19T17:49:30Z

+        if type is not None:
+            try:
+                self.type = UploadType(type)
+            except ValueError as e:
+                allowed = ", ".join(item.value for item in UploadType)


Сигнатура InputMediaBuffer.__init__ по-прежнему аннотирует type как UploadType | None, но ниже вы явно поддерживаете строки через UploadType(type). Это делает новый публичный API несогласованным (и ухудшает опыт статической типизации). Обновите аннотацию параметра до UploadType | str | None (и синхронизируйте описание аргумента в докстринге).

Copilot · 2026-04-19T17:49:30Z

+        if type is not None:
+            try:
+                self.type = UploadType(type)
+            except ValueError as e:
+                allowed = ", ".join(item.value for item in UploadType)
+                raise ValueError(
+                    f"Неверный тип загружаемого файла: {type!r}. Ожидается: {allowed}"  # noqa: E501
+                ) from e


Логика приведения/валидации type (через UploadType(type) + формирование списка allowed) продублирована в InputMedia и InputMediaBuffer. Лучше вынести её в общий хелпер (например, модульную функцию), чтобы в будущем не разъехались формат ошибки/правила валидации.

Copilot · 2026-04-19T17:49:30Z

+    def __init__(self, path: str, type: UploadType | str | None = None):
        """
        Инициализирует объект медиафайла.

        Args:
            path (str): Путь к файлу.
-            type (UploadType, optional): Тип файла. Если не указан,
+            type (UploadType, str, optional): Тип файла. Если не указан,
                определяется автоматически.
        """

        self.path = path
-        self.type = type or self.__detect_file_type(path)
-
-    def __detect_file_type(self, path: str) -> UploadType:
-        """
-        Определяет тип файла на основе его содержимого (MIME-типа).
-
-        Args:
-            path (str): Путь к файлу.

-        Returns:
-            UploadType: Тип файла (VIDEO, IMAGE, AUDIO или FILE).
-        """
+        if type is not None:
+            try:
+                self.type = UploadType(type)
+            except ValueError as e:
+                allowed = ", ".join(item.value for item in UploadType)
+                raise ValueError(
+                    f"Неверный тип загружаемого файла: {type!r}. Ожидается: {allowed}"  # noqa: E501
+                ) from e
+        else:
+            self.type = detect_file_type(InputMedia._read_file_sample(path))


Добавлена новая функциональность: принимать type как строку и выбрасывать ValueError с перечислением допустимых значений. В тестах сейчас нет проверок этого сценария (особенно: строка валидная → корректный UploadType, строка невалидная → ожидаемое сообщение ошибки). Стоит добавить/расширить тесты для InputMedia и InputMediaBuffer, чтобы зафиксировать контракт.

codecov · 2026-04-20T20:14:10Z

Codecov Report

❌ Patch coverage is 72.22222% with 10 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
maxapi/types/input_media.py	72.22%	10 Missing ⚠️

📢 Thoughts on this report? Let us know!

Olegt0rr

Хорошая работа. Рефакторинг детекции типа в detect_file_type — правильное решение, убирает дублирование между InputMedia и InputMediaBuffer. Логика валидации с понятным сообщением об ошибке тоже на месте.

Тесты покрывают основные сценарии, включая проверку что при явно переданном типе автодетект не вызывается — именно то, что нужно.

Судя по боту coverage - где-то пропущено покрытие.
По комментариям Copilot хорошо бы пробежаться внимательно. Если не актуально - напишите, позакрываю.

Косметический момент: в docstring InputMediaBuffer.init порядок типов записан как type (UploadType, optional, str) — немного странно, лучше UploadType | str | None как в сигнатуре. Не блокирует.

someqst · 2026-04-23T07:27:39Z

@Olegt0rr
По замечаниям copilot я прошелся, docstring изменил. Дописал тесты на которые, вроде бы, ругался codecov

…как строку вынесена валидация типа медиа обновлен docstring detect_file_type исправлены аннотации добавлены тесты на проверку InputMedia и InputMediaBuffer исправлена ошибка ruff fix: исправлены замечания ruff fix: исправлены docstring feat: дополнены тесты mime_type=None fix: исправлена логика validate_uploading_type исправлены замечания ruff fix: formatting

Copilot

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-04-26T07:30:45Z

+    try:
+        matches = puremagic.magic_string(data)
+        if matches:
+            mime_type = matches[0].mime_type


puremagic.magic_string() results are treated as tuples elsewhere in the codebase (e.g. maxapi/connection/base.py:265-268 uses matches[0][1] for MIME). Here matches[0].mime_type will raise AttributeError when matches[0] is a tuple. Please extract MIME consistently (e.g. tuple indexing) or normalize the result before accessing it.

Suggested change

mime_type = matches[0].mime_type

match = matches[0]

if isinstance(match, (tuple, list)) and len(match) > 1:

mime_type = match[1]

else:

mime_type = getattr(match, "mime_type", None)

Здесь matches - это list из namedtuple. Луче обратиться по атрибуту. Исправил поведение в maxapi/connection/base.py, там обращение в принципе было не к mime_type по индексу элемента в кортеже.

Copilot · 2026-04-26T07:30:45Z

    Attributes:
        path (str): Путь к файлу.
-        type (UploadType): Тип файла, определенный на основе содержимого
+        type (UploadType | str | None): Тип файла, определенный на основе содержимого
            (MIME-типа).
-    """
+    """  # noqa: E501


InputMedia.type is always set to an UploadType instance (either via validate_uploading_type() or detect_file_type()), but the docstring/types currently describe the attribute as UploadType | str | None. Consider keeping the constructor parameter as UploadType | str | None but tightening the stored attribute annotation/docstring to UploadType to avoid misleading users and type-checkers.

Copilot · 2026-04-26T07:30:45Z

    Attributes:
        buffer (bytes): Буфер с содержимым файла.
-        type (UploadType): Тип файла, определенный по содержимому.
+        type (UploadType | str | None): Тип файла, определенный по содержимому.
    """


InputMediaBuffer.type is always set to an UploadType instance after initialization, but the docstring/types currently describe the attribute as UploadType | str | None. Consider documenting/annotating the attribute as UploadType (while keeping the constructor parameter as UploadType | str | None) so consumers and type-checkers don't assume str/None are possible post-init.

Copilot · 2026-04-26T07:30:46Z

+    @pytest.mark.asyncio
+    async def test_default_upload_type_input_media_buffer(self, tmp_path):
+        """
+        Если mimetype не определился (None),
+        для файла должен вернуться тип UploadType.FILE
+        """
+        media = InputMediaBuffer(
+            buffer=b"fake-bytes",
+            filename="sample.bin",
+        )
+
+        assert media.type == UploadType.FILE
+


These tests are marked async/@pytest.mark.asyncio but don't await anything. Making them synchronous (def ...) and dropping the asyncio marker will reduce overhead and avoid implying async behavior where there is none.

Copilot · 2026-04-26T07:30:46Z

+    @pytest.mark.asyncio
+    async def test_default_upload_type_input_media(self, tmp_path):
+        """
+        Если mimetype не определился (None),
+        для файла должен вернуться тип UploadType.FILE
+        """
+        test_file = tmp_path / "sample.bin"
+        test_file.write_bytes(b"fake-data")
+
+        media = InputMedia(path=test_file)
+
+        assert media.type == UploadType.FILE


This test is marked async/@pytest.mark.asyncio but doesn't await anything. Converting it to a normal synchronous test (def ...) and dropping the asyncio marker will make intent clearer and avoid unnecessary event-loop setup.

Copilot · 2026-04-26T07:30:46Z

        Args:
            path (str): Путь к файлу.
-            type (UploadType, optional): Тип файла. Если не указан,
+            type (UploadType | str |None): Тип файла. Если не указан,


someqst · 2026-04-26T12:23:05Z

@Olegt0rr
Классно, что получилось найти баг благодаря копилоту. В maxapi/connection/base на 267 строке был бажок, обращение по факту не к mime_type происходило, а к offset.
Замечания copilot я исправил.

someqst force-pushed the feat/allow-str-upload-type-while-upload_media branch from e042e8a to ad07ed4 Compare April 18, 2026 21:51

Olegt0rr requested a review from Copilot April 19, 2026 17:45

Copilot started reviewing on behalf of Olegt0rr April 19, 2026 17:46 View session

Copilot AI reviewed Apr 19, 2026

View reviewed changes

Olegt0rr mentioned this pull request Apr 22, 2026

feat: возможность для пользователя передать action как строку #118

Open

Olegt0rr self-requested a review April 22, 2026 22:02

Olegt0rr requested changes Apr 22, 2026

View reviewed changes

someqst force-pushed the feat/allow-str-upload-type-while-upload_media branch from 16f82ef to 413abae Compare April 23, 2026 08:29

Olegt0rr requested a review from Copilot April 26, 2026 07:26

Copilot started reviewing on behalf of Olegt0rr April 26, 2026 07:26 View session

Copilot AI reviewed Apr 26, 2026

View reviewed changes

someqst added 3 commits April 26, 2026 12:12

fix: неверное обращение к mime_type объекта PureMagicWithConfidence

9e5e1d9

remove async from not async tests

b2a4be8

fix: косметические изменения

40e1747

-            mime_type = matches[0].mime_type
+            match = matches[0]
+            if isinstance(match, (tuple, list)) and len(match) > 1:
+                mime_type = match[1]
+            else:
+                mime_type = getattr(match, "mime_type", None)

	type (UploadType \| str \|None): Тип файла. Если не указан,
	type (UploadType \| str \| None): Тип файла. Если не указан,

Conversation

someqst commented Apr 18, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

Uh oh!

codecov Bot commented Apr 20, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Olegt0rr left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

someqst commented Apr 23, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

someqst Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 26, 2026

Choose a reason for hiding this comment

Uh oh!

someqst commented Apr 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

codecov Bot commented Apr 20, 2026 •

edited

Loading

Olegt0rr left a comment •

edited

Loading

someqst commented Apr 26, 2026 •

edited

Loading