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_optionssowieWebLoadOptions.margin_settings/orientation_settings/size_settings(CONVERSIONPYTHON-97) - [Feature] Hinzufügen von
ImageConvertOptions.min_resolutionundcap_resolution_to_page_content(CONVERSIONPYTHON-98) - [Feature] Hinzufügen von
WordProcessingLoadOptions.auto_detect_rtl_direction(CONVERSIONPYTHON-99) - [Feature] Einführung von
MissingDependencyExceptionfü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 Siegroupdocs.conversion.filetypes(CONVERSIONPYTHON-102) - [Enhancement] Umbenennen von
PdfOptions.remove_pdf_acompliancezuremove_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
itemauf*DocumentInfoundPossibleConversionsist 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 inIConversionFromundIConversionSettingsConverter(...)— vier neue Konstruktor‑Überladungen, die einConversionEventsakzeptierenCadLoadOptions.layout_scopeEmailLoadOptions.page_layout_optionsWebLoadOptions.margin_settings,.orientation_settings,.size_settingsMarkdownOptions.image_saving_callbackImageConvertOptions.min_resolution,.cap_resolution_to_page_contentWordProcessingLoadOptions.auto_detect_rtl_directionCompressionFileType.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.