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

What’s new in this release

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

Public API changes

New Functional Methods – эти методы были объявлены в 25.12, но вызывали NotImplementedError. Теперь они работают:

Method Returns Description
Converter.convert_by_page(output_dir, convert_options) None Делит документ на отдельные файлы по страницам в указанной директории
Converter.convert_to_stream(convert_options) bytes Конвертирует документ и возвращает результат в виде байтов в памяти

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

Method Status Workaround
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) для получения единого файла из архивов

New features

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

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

Python 3.14 Support
Диапазон поддерживаемых версий 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 Agent and LLM Integration
Пакет groupdocs-conversion теперь включает файл AGENTS.md по пути groupdocs/conversion/AGENTS.md внутри wheel. AI‑ассистенты, сканирующие установленные пакеты (например, Claude Code, Cursor и GitHub Copilot), могут автоматически обнаруживать API, примеры использования, пути импорта и советы по устранению неполадок без дополнительного руководства.

Format Object Properties
Объекты формата, возвращаемые 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() и предоставляют чистые строковые значения через перечисленные свойства.

Code example

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, ...

How to get the update

PyPI

pip install --upgrade groupdocs-conversion

Resources