GroupDocs.Conversion for Python v26.3 теперь доступен. Этот релиз добавляет конвертацию по страницам, вывод в поток в памяти, поддержку Python 3.14, файлы интеграции AI‑агентов, расширенные метаданные форматов и несколько улучшений.

Что нового в этом релизе

Ключ Категория Краткое описание
CONVERSIONPYTHON-65 Функция Конвертация по страницам через convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Функция Конвертация в памяти через convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Функция Поддержка Python 3.14
CONVERSIONPYTHON-64 Функция Включение AGENTS.md в пакет для интеграции AI‑агентов
CONVERSIONPYTHON-67 Улучшение Объекты форматов раскрывают свойства .extension, .file_format, .description
CONVERSIONPYTHON-68 Улучшение Явный классификатор macOS в метаданных PyPI

Изменения публичного API

Новые функциональные методы – эти методы были объявлены в версии 25.12, но вызывали NotImplementedError. Теперь они работают:

Метод Возвращаемое значение Описание
Converter.convert_by_page(output_dir, convert_options) None Разделяет документ на отдельный файл для каждой страницы в указанном каталоге
Converter.convert_to_stream(convert_options) bytes Конвертирует документ и возвращает результат в виде байтов в памяти

Методы, пока недоступные – следующие методы существуют как прокси‑атрибуты в классе Converter, но пока не работают в Python‑обёртке. Их вызов вызовет исключение:

Метод Статус Обходной путь
convert_by_page(file_path, page_number, convert_options) TypeError — перегрузка с 3 аргументами не доступна Используйте convert_options.page_number + convert_options.pages_count = 1 с convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — перегрузка с 3 аргументами не доступна Сконвертировать в файл, затем прочитать в io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Используйте convert(file_path, options) для получения единого файла из архивов

Новые возможности

Конвертация по страницам – convert_by_page
Converter.convert_by_page(output_dir, convert_options) теперь полностью функционирует. Он разбивает многостраничный документ на отдельные файлы — по одному на страницу — сохраняет их в указанный каталог. Файлы страниц называются page_1.ext, page_2.ext и т.д. Этот метод работает со всеми классами ConvertOptions, поддерживающими вывод по страницам, такими как ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions и другими.

Конвертация в памяти – convert_to_stream
Converter.convert_to_stream(convert_options) теперь возвращает конвертированный документ как объект Python bytes, позволяя выполнять конвертацию в памяти без записи на диск. Это полезно для облачных функций, веб‑приложений и потоковых архитектур, где доступ к файловой системе ограничен или нежелателен.

Поддержка Python 3.14
Поддерживаемый диапазон версий Python расширен с 3.5–3.13 (25.12) до 3.5–3.14. Метаданные Requires-Python теперь указывают >=3.5,<3.15, а страница PyPI явно перечисляет классификаторы для Python 3.8‑3.14.

AGENTS.md – интеграция AI‑агентов и LLM
Пакет groupdocs-conversion теперь включает файл AGENTS.md по пути groupdocs/conversion/AGENTS.md внутри wheel. AI‑ассистенты по программированию, сканирующие установленные пакеты — такие как Claude Code, Cursor и GitHub Copilot — могут автоматически обнаруживать API, шаблоны использования, пути импорта и советы по устранению неполадок без ручного вмешательства.

Свойства объектов формата
Объекты форматов, возвращаемые get_possible_conversions() и get_all_possible_conversions(), теперь раскрывают человекочитаемые свойства:

  • .extension – например, 'pdf'
  • .file_format – например, 'Portable Document Format'
  • .description – например, 'Portable Document Format File (pdf)'

Ранее эти объекты отображались как непрозрачные <NetObject handle=NNN>; теперь они показываются как <NetObject pdf> в repr() и предоставляют чистые строковые значения через перечисленные свойства.

Пример кода

import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)

with Converter("./presentation.pptx") as converter:
    options = ImageConvertOptions()
    options.format = ImageFileType.PNG
    converter.convert_by_page(output_dir, options)
    # produces: page_1.png, page_2.png, ...

Как получить обновление

PyPI

pip install --upgrade groupdocs-conversion

Ресурсы