GroupDocs.Conversion für Python v26.3 ist jetzt verfügbar. Dieses Release fügt die konvertierung pro Seite, Ausgabe in Speicher‑Streams, Unterstützung für Python 3.14, AI‑Agent‑Integrationsdateien, erweiterte Format‑Metadaten und mehrere Verfeinerungen hinzu.

What’s new in this release

Schlüssel Kategorie Zusammenfassung
CONVERSIONPYTHON-65 Feature Seitenweise Konvertierung über convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Feature In‑Memory‑Konvertierung über convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Feature Unterstützung für Python 3.14
CONVERSIONPYTHON-64 Feature Versand von AGENTS.md im Paket für AI‑Agent‑Integration
CONVERSIONPYTHON-67 Enhancement Format‑Objekte stellen die Eigenschaften .extension, .file_format, .description bereit
CONVERSIONPYTHON-68 Enhancement Expliziter macOS‑Classifier in den PyPI‑Metadaten

Public API changes

Neue funktionale Methoden – diese Methoden wurden in 25.12 deklariert, lösten jedoch NotImplementedError aus. Sie sind jetzt funktionsfähig:

Methode Rückgabewert Beschreibung
Converter.convert_by_page(output_dir, convert_options) None Teilt ein Dokument in einzelne Dateien pro Seite im angegebenen Verzeichnis
Converter.convert_to_stream(convert_options) bytes Konvertiert das Dokument und gibt das Ergebnis als In‑Memory‑Bytes zurück

Methoden noch nicht verfügbar – die folgenden Methoden existieren als Attribut‑Proxys in der Converter‑Klasse, sind jedoch noch nicht funktional im Python‑Binding. Ein Aufruf führt zu einer Ausnahme:

Methode Status Workaround
convert_by_page(file_path, page_number, convert_options) TypeError — 3‑Argument‑Überladung nicht verfügbar Verwende convert_options.page_number + convert_options.pages_count = 1 mit convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — 3‑Argument‑Überladung nicht verfügbar Konvertiere in eine Datei und lese sie anschließend in io.BytesIO ein
convert_multiple(folder_path, convert_options) MissingMethodException Verwende convert(file_path, options) für eine konsolidierte Ein‑Datei‑Ausgabe aus Archiven

New features

Per‑Page Conversion – convert_by_page
Die Methode Converter.convert_by_page(output_dir, convert_options) ist nun vollständig funktionsfähig. Sie teilt ein mehrseitiges Dokument in einzelne Ausgabedateien – eine pro Seite – und speichert sie im angegebenen Verzeichnis. Seitendateien werden benannt page_1.ext, page_2.ext usw. Diese Methode funktioniert für alle ConvertOptions‑Klassen, die eine seitenbasierte Ausgabe unterstützen, wie ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions und weitere.

In‑Memory Conversion – convert_to_stream
Die Methode Converter.convert_to_stream(convert_options) gibt nun das konvertierte Dokument als Python‑bytes‑Objekt zurück, wodurch In‑Memory‑Konvertierungspipelines ohne Dateisystemzugriff ermöglicht werden. Das ist nützlich für Cloud‑Funktionen, Web‑Anwendungen und Streaming‑Architekturen, bei denen der Zugriff auf das Dateisystem eingeschränkt oder unerwünscht ist.

Python 3.14 Support
Der unterstützte Python‑Versionsbereich wurde von 3.5–3.13 (25.12) auf 3.5–3.14 erweitert. Die Requires-Python‑Metadaten lauten jetzt >=3.5,<3.15, und die PyPI‑Seite listet explizit Classifier für Python 3.8 bis 3.14 auf.

AGENTS.md – AI Agent und LLM Integration
Das groupdocs-conversion‑pip‑Paket liefert nun eine AGENTS.md‑Datei unter groupdocs/conversion/AGENTS.md im Wheel. KI‑Coding‑Assistenten, die installierte Pakete scannen – wie Claude Code, Cursor und GitHub Copilot – können automatisch die API‑Oberfläche, Nutzungsmuster, Importpfade und Fehlersuch‑Tipps entdecken, ohne manuelle Anleitung.

Format Object Properties
Format‑Objekte, die von get_possible_conversions() und get_all_possible_conversions() zurückgegeben werden, stellen jetzt menschenlesbare Eigenschaften bereit:

  • .extension – z. B. 'pdf'
  • .file_format – z. B. 'Portable Document Format'
  • .description – z. B. 'Portable Document Format File (pdf)'

Zuvor wurden diese Objekte als undurchsichtige <NetObject handle=NNN> dargestellt; sie erscheinen jetzt als <NetObject pdf> in repr() und bieten saubere String‑Werte über die oben genannten Eigenschaften.

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