Wir freuen uns, die Veröffentlichung von GroupDocs.Conversion for Python v26.9 bekannt zu geben, verfügbar seit September 2026. Dieses Release aktualisiert die zugrunde liegende GroupDocs.Conversion‑Engine von 26.3 auf 26.8, führt die ConversionEvents‑API für die Echtzeit‑Überwachung von Konvertierungen ein, erweitert die Unterstützung um XAR‑Archive, draw.io‑ und Mermaid‑Diagramme und enthält mehrere neue Lade‑ und Konvertierungsoptionen. Außerdem werden kritische Kompatibilitätsprobleme in Python 3.5–3.10 behoben und langjährige Defekte bei delegate‑typisierten Eigenschaften und Enum‑Argumenten korrigiert.

Was ist neu in dieser Version

  • [Feature] Unterstützung für ConversionEvents, um Start, Fortschritt, Seiten‑ und Dokumentabschluss, Fehler und Schriftart‑Ersetzung zu beobachten (CONVERSIONPYTHON-93)
  • [Feature] Unterstützung für neue Formate — XAR‑Archive, draw.io‑Diagramme und Mermaid‑Diagramme (.mmd) (CONVERSIONPYTHON-94)
  • [Feature] Hinzufügen von CadLoadOptions.layout_scope, um die CAD‑Konvertierung auf Modell‑Space, Papier‑Space‑Layouts oder beides zu beschränken (CONVERSIONPYTHON-95)
  • [Feature] Hinzufügen von MarkdownOptions.image_saving_callback, um zu steuern, wohin Bilder, die beim Export nach Markdown extrahiert werden, geschrieben werden (CONVERSIONPYTHON-96)
  • [Feature] Hinzufügen von EmailLoadOptions.page_layout_options sowie WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
  • [Feature] Hinzufügen von ImageConvertOptions.min_resolution und cap_resolution_to_page_content (CONVERSIONPYTHON-98)
  • [Feature] Hinzufügen von WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
  • [Feature] Einführung von MissingDependencyException für eine klarere Fehlermeldung, wenn eine optionale Engine‑Abhängigkeit fehlt (CONVERSIONPYTHON-100)
  • [Enhancement] Aktualisierung der GroupDocs.Conversion‑Engine von 26.3 auf 26.8 (CONVERSIONPYTHON-101)
  • [Enhancement] Entfernen des doppelten Moduls groupdocs.conversion.file_types — verwenden Sie groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
  • [Enhancement] Umbenennen von PdfOptions.remove_pdf_acompliance zu remove_pdf_a_compliance (CONVERSIONPYTHON-103)
  • [Enhancement] Hinzufügen eines Developer‑Guide‑Abschnitts und der Seiten groupdocs.conversion.integration.* zur API‑Referenz (CONVERSIONPYTHON-104)
  • [Fix] Modul kann nicht importiert werden, wenn Python 3.5 – 3.7 verwendet wird (CONVERSIONPYTHON-91)
  • [Fix] Laufzeitfehler beim Übergeben eines Enum‑Arguments in Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
  • [Fix] Indexer item auf *DocumentInfo und PossibleConversions ist eine Eigenschaft und kann nicht aufgerufen werden (CONVERSIONPYTHON-105)
  • [Fix] Delegate‑typisierte Eigenschaften können nicht aus Python zugewiesen werden (Object must implement IConvertible) (CONVERSIONPYTHON-106)
  • [Fix] Delegate‑typisierte Eigenschaften sind in Stubs und Docstrings mit dem falschen Typ annotiert (CONVERSIONPYTHON-107)

Änderungen an der öffentlichen API

Neue Klassen

Klasse Modul
ConversionEvents groupdocs.conversion
FontSubstitutionContext groupdocs.conversion.contracts
XarDocumentInfo groupdocs.conversion.contracts
MissingDependencyException groupdocs.conversion.exceptions
CadLayoutScope groupdocs.conversion.options.load
IPageLayoutOptions groupdocs.conversion.options.load
MarkdownImageSavingArgs, IMarkdownImageSavingCallback groupdocs.conversion.options.convert
IConversionHandlersStage, IConversionByPageHandlersStage groupdocs.conversion.fluent

Neue Mitglieder in bestehenden Klassen

  • FluentConverter.with_events(...) sowie die entsprechenden Methoden in IConversionFrom und IConversionSettings
  • Converter(...) — vier neue Konstruktor‑Überladungen, die ein ConversionEvents akzeptieren
  • CadLoadOptions.layout_scope
  • EmailLoadOptions.page_layout_options
  • WebLoadOptions.margin_settings, .orientation_settings, .size_settings
  • MarkdownOptions.image_saving_callback
  • ImageConvertOptions.min_resolution, .cap_resolution_to_page_content
  • WordProcessingLoadOptions.auto_detect_rtl_direction
  • CompressionFileType.XAR, DiagramFileType.DRAWIO, DiagramFileType.MMD

Entfernt — groupdocs.conversion.file_types

Das Modul groupdocs.conversion.file_types und seine 23 Klassen wurden entfernt. Die Klassen selbst sind nicht entfernt — jede von ihnen existiert weiterhin unverändert in groupdocs.conversion.filetypes.

Wenn Sie von diesem Modul importiert haben, ändern Sie den Import — nichts weiter:

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

Umbenannt — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

Neue Funktionen

Konvertierungsereignisse

ConversionEvents ermöglicht das Beobachten einer laufenden Konvertierung — Fortschritt, Seiten‑ und Dokumentabschluss, Fehler und Schriftart‑Ersetzung. Binden Sie gewöhnliche Python‑Funktionen ein:

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

Beachten Sie, dass der Konstruktor (path, settings, events) erwartet — es gibt keine Überladung (path, events). Daher übergeben Sie ein ConverterSettings() selbst dann, wenn Sie nichts konfigurieren müssen.

Verfügbare Hooks sind on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed und on_font_substituted.

Neue Formate

Format Dateityp‑Konstante Hinweise
XAR‑Archiv CompressionFileType.XAR Auch XarDocumentInfo zur Inspektion verfügbar
draw.io‑Diagramm DiagramFileType.DRAWIO
Mermaid‑Diagramm DiagramFileType.MMD

CAD‑Layout‑Bereich

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH ist die Vorgabe und schränkt die Konvertierung nicht ein.

Codebeispiel

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

So erhalten Sie das Update

PyPI

pip install groupdocs-conversion-net==26.9.0

Direkter Download

Download von der Seite GroupDocs.Conversion for Python via .NET 26.9.

Ressourcen