GroupDocs.Conversion for Python 26.9 – Eylül 2026 Sürüm Öne Çıkanları

We’re happy to announce the release of GroupDocs.Conversion for Python v26.9, available as of September 2026. This release upgrades the underlying GroupDocs.Conversion engine from 26.3 to 26.8, introduces the ConversionEvents API for real‑time conversion monitoring, adds support for XAR archives, draw.io, and Mermaid diagrams, and includes several new load and convert options. It also resolves critical compatibility issues on Python 3.5–3.10 and fixes longstanding defects affecting delegate‑typed properties and enum arguments.

Bu sürümde yeni olanlar

• [Feature] ConversionEvents desteği ekleyerek dönüşümün başlangıç, ilerleme, sayfa‑sayfa ve belge‑bazlı tamamlanma, hatalar ve font ikamesi izlenebilmesi (CONVERSIONPYTHON-93)
• [Feature] Yeni formatlar — XAR arşivleri, draw.io diyagramları ve Mermaid (.mmd) diyagramları desteği (CONVERSIONPYTHON-94)
• [Feature] CadLoadOptions.layout_scope eklenerek CAD dönüşümünün model alanı, kağıt‑alanı düzenleri veya her ikisiyle sınırlanabilmesi (CONVERSIONPYTHON-95)
• [Feature] MarkdownOptions.image_saving_callback eklenerek Markdown’a çıkarılan görsellerin nereye kaydedileceği kontrol edilebiliyor (CONVERSIONPYTHON-96)
• [Feature] EmailLoadOptions.page_layout_options ve WebLoadOptions.margin_settings / orientation_settings / size_settings eklenmesi (CONVERSIONPYTHON-97)
• [Feature] ImageConvertOptions.min_resolution ve cap_resolution_to_page_content eklenmesi (CONVERSIONPYTHON-98)
• [Feature] WordProcessingLoadOptions.auto_detect_rtl_direction eklenmesi (CONVERSIONPYTHON-99)
• [Feature] Opsiyonel motor bağımlılığı eksik olduğunda daha net bir hata mesajı veren MissingDependencyException eklenmesi (CONVERSIONPYTHON-100)
• [Enhancement] GroupDocs.Conversion motorunun 26.3’ten 26.8’e güncellenmesi (CONVERSIONPYTHON-101)
• [Enhancement] Çift groupdocs.conversion.file_types modülü kaldırıldı — groupdocs.conversion.filetypes kullanılmalı (CONVERSIONPYTHON-102)
• [Enhancement] PdfOptions.remove_pdf_acompliance adı remove_pdf_a_compliance olarak değiştirildi (CONVERSIONPYTHON-103)
• [Enhancement] API referansına Developer Guide bölümü ve groupdocs.conversion.integration.* sayfaları eklendi (CONVERSIONPYTHON-104)
• [Fix] Python 3.5 – 3.7 kullanırken modül içe aktarılamama sorunu giderildi (CONVERSIONPYTHON-91)
• [Fix] Python 3.8 – 3.10 sürümlerinde Enum argümanı geçirilirken oluşan çalışma zamanı hatası düzeltildi (CONVERSIONPYTHON-92)
• [Fix] *DocumentInfo ve PossibleConversions üzerindeki item indeksleyicisi bir özellik olduğundan çağrılamıyordu (CONVERSIONPYTHON-105)
• [Fix] Delegate‑tipi özellikler Python’dan atanamıyordu (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Delegate‑tipi özellikler stub ve docstring’lerde yanlış tip ile işaretlenmişti (CONVERSIONPYTHON-107)

Genel API değişiklikleri

Yeni sınıflar

Mevcut sınıflara yeni üyeler

• FluentConverter.with_events(...) ve aynı metod IConversionFrom ve IConversionSettings üzerinde
• Converter(...) — ConversionEvents kabul eden dört yeni kurucu aşırı yükleme
• 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

Kaldırıldı — groupdocs.conversion.file_types

groupdocs.conversion.file_types modülü ve içindeki 23 sınıf artık yok. Sınıflar kendileri silinmedi — hepsi hâlâ groupdocs.conversion.filetypes içinde, aynı isimle bulunuyor.

Eğer bu modülden içe aktarma yapıyorsanız, import satırını değiştirin — başka bir şey yapmanıza gerek yok:

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

Yeniden adlandırıldı — PdfOptions.remove_pdf_acompliance

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

Yeni özellikler

Dönüşüm olayları

ConversionEvents, bir dönüşüm çalışırken ilerleme, sayfa‑sayfa ve belge‑bazlı tamamlanma, hatalar ve font ikamesi gibi durumları gözlemlemenizi sağlar. Normal Python fonksiyonları ekleyin:

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

Kurucu (path, settings, events) parametrelerini alır — (path, events) şeklinde bir aşırı yükleme yoktur, bu yüzden ConverterSettings() nesnesini, hiçbir ayar yapmasanız bile, geçirmeniz gerekir.

Kullanılabilir kancalar: on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed ve on_font_substituted.

Yeni formatlar

CAD düzen kapsamı

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

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

BOTH varsayılan değerdir ve dönüşümü kısıtlamaz.

Kod örneği

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

Güncellemeyi nasıl alabilirsiniz

PyPI

pip install groupdocs-conversion-net==26.9.0

Doğrudan indirme

GroupDocs.Conversion for Python via .NET 26.9 sayfasından indirin.

Kaynaklar

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