GroupDocs.Conversion for Python 26.9 – Září 2026 – Přehled vydání

Jsme rádi, že můžeme oznámit vydání GroupDocs.Conversion for Python v26.9, dostupné od září 2026. Toto vydání aktualizuje podkladový engine GroupDocs.Conversion z verze 26.3 na 26.8, zavádí API ConversionEvents pro sledování konverze v reálném čase, přidává podporu pro XAR archivy, draw.io a Mermaid diagramy a obsahuje několik nových možností načítání a konverze. Také řeší kritické problémy kompatibility v Pythonu 3.5–3.10 a opravuje dlouhodobé chyby týkající se vlastností typu delegate a argumentů výčtů.

Co je nového v tomto vydání

• [Feature] Přidat podporu pro ConversionEvents pro sledování zahájení, průběhu, dokončení po stránce i po dokumentu, selhání a náhrady fontů (CONVERSIONPYTHON-93)
• [Feature] Přidat podporu pro nové formáty — XAR archivy, draw.io diagramy a Mermaid (.mmd) diagramy (CONVERSIONPYTHON-94)
• [Feature] Přidat CadLoadOptions.layout_scope pro omezení CAD konverze na modelový prostor, rozvržení papírového prostoru nebo oba (CONVERSIONPYTHON-95)
• [Feature] Přidat MarkdownOptions.image_saving_callback pro řízení, kam se ukládají obrázky extrahované do Markdownu (CONVERSIONPYTHON-96)
• [Feature] Přidat EmailLoadOptions.page_layout_options a WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] Přidat ImageConvertOptions.min_resolution a cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] Přidat WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] Přidat MissingDependencyException pro srozumitelnější selhání, když chybí volitelná závislost enginu (CONVERSIONPYTHON-100)
• [Enhancement] Aktualizovat engine GroupDocs.Conversion z 26.3 na 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] Odstranit duplicitní modul groupdocs.conversion.file_types — používejte groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] Přejmenovat PdfOptions.remove_pdf_acompliance na remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] Přidat sekci Průvodce vývojářem a stránky groupdocs.conversion.integration.* do referenční dokumentace API (CONVERSIONPYTHON-104)
• [Fix] Nelze importovat modul při použití Pythonu 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] Chyba za běhu při předávání argumentu Enum v Pythonu 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] Indexer item na *DocumentInfo a PossibleConversions je vlastnost a nelze jej volat (CONVERSIONPYTHON-105)
• [Fix] Vlastnosti typu delegate nelze přiřadit z Pythonu (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Vlastnosti typu delegate jsou v stubech a docstringech anotovány nesprávným typem (CONVERSIONPYTHON-107)

Změny v veřejném API

Nové třídy

Nové členy existujících tříd

• FluentConverter.with_events(...) a totéž na IConversionFrom a IConversionSettings
• Converter(...) — čtyři nové přetížení konstruktoru přijímající ConversionEvents
• 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

Odstraněno — groupdocs.conversion.file_types

Modul groupdocs.conversion.file_types a jeho 23 tříd byly odstraněny. Samotné třídy zůstávají — každá z nich stále existuje, beze změny, v groupdocs.conversion.filetypes.

Pokud jste je importovali, změňte import — nic jiného:

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

Přejmenováno — PdfOptions.remove_pdf_acompliance

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

Nové funkce

Události konverze

ConversionEvents vám umožňuje sledovat konverzi během jejího běhu — průběh, dokončení po stránce i po dokumentu, selhání a náhrady fontů. Připojte běžné Python funkce:

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

Všimněte si, že konstruktor přijímá (path, settings, events) — neexistuje přetížení (path, events), takže i když nepotřebujete konfigurovat nastavení, předávejte ConverterSettings().

Dostupné háčky jsou on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed a on_font_substituted.

Nové formáty

Rozsah rozvržení CAD

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

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

BOTH je výchozí a neomezuje konverzi.

Příklad kódu

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

Jak získat aktualizaci

PyPI

pip install groupdocs-conversion-net==26.9.0

Přímé stažení

Stáhněte ze stránky GroupDocs.Conversion for Python via .NET 26.9 .

Zdroje

• Full Release Notes
• Product Page
• Documentation
• API Reference
• Code Examples
• Free Support Forum