We zijn blij de release van GroupDocs.Conversion for Python v26.9 aan te kondigen, beschikbaar vanaf september 2026. Deze release werkt de onderliggende GroupDocs.Conversion‑engine bij van 26.3 naar 26.8, introduceert de ConversionEvents‑API voor realtime conversiebewaking, voegt ondersteuning toe voor XAR‑archieven, draw.io‑ en Mermaid‑diagrammen, en bevat diverse nieuwe laad‑ en converteeropties. Daarnaast lost hij kritieke compatibiliteitsproblemen op in Python 3.5–3.10 en verhelpt hij langdurige defecten die delegate‑getypeerde eigenschappen en enum‑argumenten beïnvloedden.

What’s new in this release

  • [Feature] Voeg ondersteuning toe voor ConversionEvents om start, voortgang, per‑pagina‑ en per‑documentvoltooiing, fouten en lettertype‑substitutie te observeren (CONVERSIONPYTHON-93)
  • [Feature] Voeg ondersteuning toe voor nieuwe formaten — XAR‑archieven, draw.io‑diagrammen en Mermaid (.mmd)‑diagrammen (CONVERSIONPYTHON-94)
  • [Feature] Voeg CadLoadOptions.layout_scope toe om CAD‑conversie te beperken tot model‑space, paper‑space‑lay‑outs, of beide (CONVERSIONPYTHON-95)
  • [Feature] Voeg MarkdownOptions.image_saving_callback toe om te bepalen waar afbeeldingen die naar Markdown worden geëxtraheerd, worden weggeschreven (CONVERSIONPYTHON-96)
  • [Feature] Voeg EmailLoadOptions.page_layout_options en WebLoadOptions.margin_settings / orientation_settings / size_settings toe (CONVERSIONPYTHON-97)
  • [Feature] Voeg ImageConvertOptions.min_resolution en cap_resolution_to_page_content toe (CONVERSIONPYTHON-98)
  • [Feature] Voeg WordProcessingLoadOptions.auto_detect_rtl_direction toe (CONVERSIONPYTHON-99)
  • [Feature] Voeg MissingDependencyException toe voor een duidelijkere foutmelding wanneer een optionele engine‑afhankelijkheid ontbreekt (CONVERSIONPYTHON-100)
  • [Enhancement] Update GroupDocs.Conversion‑engine van 26.3 naar 26.8 (CONVERSIONPYTHON-101)
  • [Enhancement] Verwijder de dubbele module groupdocs.conversion.file_types — gebruik groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
  • [Enhancement] Hernoem PdfOptions.remove_pdf_acompliance naar remove_pdf_a_compliance (CONVERSIONPYTHON-103)
  • [Enhancement] Voeg een Developer Guide‑sectie en groupdocs.conversion.integration.*‑pagina’s toe aan de API‑referentie (CONVERSIONPYTHON-104)
  • [Fix] Kan module niet importeren bij gebruik van Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
  • [Fix] Runtime‑fout bij het doorgeven van een Enum‑argument in Python‑versies 3.8 – 3.10 (CONVERSIONPYTHON-92)
  • [Fix] Indexer item op *DocumentInfo en PossibleConversions is een eigenschap en kan niet worden aangeroepen (CONVERSIONPYTHON-105)
  • [Fix] Delegate‑getypeerde eigenschappen kunnen niet vanuit Python worden toegewezen (Object must implement IConvertible) (CONVERSIONPYTHON-106)
  • [Fix] Delegate‑getypeerde eigenschappen zijn in stubs en docstrings geannoteerd met het verkeerde type (CONVERSIONPYTHON-107)

Public API changes

Nieuwe klassen

Klasse Module
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

Nieuwe leden op bestaande klassen

  • FluentConverter.with_events(...), en hetzelfde op IConversionFrom en IConversionSettings
  • Converter(...) — vier nieuwe constructor‑overloads die een ConversionEvents accepteren
  • 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

Verwijderd — groupdocs.conversion.file_types

De module groupdocs.conversion.file_types en de 23 klassen ervan zijn verwijderd. De klassen zelf zijn niet verwijderd — elke klasse bestaat nog steeds, ongewijzigd, in groupdocs.conversion.filetypes.

Als je van deze module importeerde, wijzig dan de import — verder niets:

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

Hernoemd — PdfOptions.remove_pdf_acompliance

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

Nieuwe functies

Conversie‑events

ConversionEvents stelt je in staat een conversie te observeren terwijl deze loopt — voortgang, per‑pagina‑ en per‑documentvoltooiing, fouten en lettertype‑substitutie. Koppel gewone Python‑functies:

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())

Let op: de constructor neemt (path, settings, events) — er is geen overload (path, events), dus geef een ConverterSettings() mee, zelfs als je niets hoeft te configureren.

De beschikbare hooks zijn on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed en on_font_substituted.

Nieuwe formaten

Formaat Constante voor bestandstype Opmerkingen
XAR‑archief CompressionFileType.XAR Ook XarDocumentInfo beschikbaar voor inspectie
draw.io‑diagram DiagramFileType.DRAWIO
Mermaid‑diagram DiagramFileType.MMD

CAD‑layout‑scope

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

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

BOTH is de standaardwaarde en beperkt de conversie niet.

Code‑voorbeeld

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())

Hoe de update te verkrijgen

PyPI

pip install groupdocs-conversion-net==26.9.0

Direct download

Download van de pagina GroupDocs.Conversion for Python via .NET 26.9 .

Resources