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
ConversionEventsom 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_scopetoe om CAD‑conversie te beperken tot model‑space, paper‑space‑lay‑outs, of beide (CONVERSIONPYTHON-95) - [Feature] Voeg
MarkdownOptions.image_saving_callbacktoe om te bepalen waar afbeeldingen die naar Markdown worden geëxtraheerd, worden weggeschreven (CONVERSIONPYTHON-96) - [Feature] Voeg
EmailLoadOptions.page_layout_optionsenWebLoadOptions.margin_settings/orientation_settings/size_settingstoe (CONVERSIONPYTHON-97) - [Feature] Voeg
ImageConvertOptions.min_resolutionencap_resolution_to_page_contenttoe (CONVERSIONPYTHON-98) - [Feature] Voeg
WordProcessingLoadOptions.auto_detect_rtl_directiontoe (CONVERSIONPYTHON-99) - [Feature] Voeg
MissingDependencyExceptiontoe 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— gebruikgroupdocs.conversion.filetypes(CONVERSIONPYTHON-102) - [Enhancement] Hernoem
PdfOptions.remove_pdf_acompliancenaarremove_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
itemop*DocumentInfoenPossibleConversionsis 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 opIConversionFromenIConversionSettingsConverter(...)— vier nieuwe constructor‑overloads die eenConversionEventsaccepterenCadLoadOptions.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
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 .