GroupDocs.Conversion für Python v26.3 ist jetzt verfügbar. Dieses Release fügt seitenweise Konvertierung, In‑Memory‑Stream‑Ausgabe, Python 3.14‑Unterstützung, AI‑Agent‑Integrationsdateien, erweiterte Format‑Metadaten und mehrere Verfeinerungen hinzu.

Was ist neu in diesem Release

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

Öffentliche API‑Änderungen

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

Methode Rückgabe Beschreibung
Converter.convert_by_page(output_dir, convert_options) None Teilt ein Dokument in eine Datei 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 funktionsfähig in der Python‑Bindung. Ein Aufruf löst eine Ausnahme aus:

Methode Status Umgehungslösung
convert_by_page(file_path, page_number, convert_options) TypeError — 3‑Argument‑Überladung nicht verfügbar Verwenden Sie 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 In Datei konvertieren, dann in io.BytesIO einlesen
convert_multiple(folder_path, convert_options) MissingMethodException Verwenden Sie convert(file_path, options) für eine konsolidierte Ein‑Datei‑Ausgabe aus Archiven

Neue Funktionen

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

In‑Memory‑Konvertierung – 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 Schreibvorgänge auf die Festplatte ermöglicht werden. Das ist nützlich für Cloud‑Funktionen, Web‑Anwendungen und Streaming‑Architekturen, bei denen Dateisystemzugriff eingeschränkt oder unerwünscht ist.

Python 3.14‑Unterstützung
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 – KI‑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.

Formatobjekteigenschaften
Formatobjekte, 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 Zeichenkettenwerte über die oben genannten Eigenschaften.

Codebeispiel

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)
    # erzeugt: page_1.png, page_2.png, ...

Wie Sie das Update erhalten

PyPI

pip install --upgrade groupdocs-conversion

Ressourcen