GroupDocs.Conversion for Python v26.3 тепер доступний. У цьому випуску додано конвертацію по сторінках, вивід у пам’ять, підтримку Python 3.14, файли інтеграції AI‑агента, розширені метадані форматів та кілька удосконалень.

Що нового в цьому випуску

Ключ Категорія Коротко
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

Зміни у публічному 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) тепер повертає конвертований документ як об’єкт bytes у Python, що дозволяє будувати конвеєри конвертації в пам’яті без запису на диск. Це корисно для хмарних функцій, веб‑додатків та потокових архітектур, де доступ до файлової системи обмежений або небажаний.

Підтримка 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 у pip тепер містить файл AGENTS.md за шляхом groupdocs/conversion/AGENTS.md всередині колеса. 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

Ресурси